grpc-requests

What it is and what it does

grpc_requests wraps the gRPC Python client to provide a familiar, requests-like interface for calling gRPC services. Instead of generating stubs from .proto files, it leverages server reflection to discover available services and methods at runtime, then lets you call them with plain dictionaries. It supports unary and streaming methods, TLS/SSL connections, metadata headers, compression, and both sync and async APIs.

The library targets modern Python versions (3.9–3.13) and maintains compatibility with current protobuf releases. It depends on grpcio, grpcio-reflection, protobuf, google-api-core, and cryptography. Recent releases have added async iterator support, lazy service loading, and custom message parsing, making it suitable for both simple one-off calls and more complex service interactions.

Use it for:

• Testing or debugging gRPC services without generating client stubs from .proto files.
• Building dynamic gRPC clients that discover and call services at runtime via reflection.
• Integrating gRPC calls into Python scripts or tools where requests-like simplicity is preferred.
• Async applications that need to call multiple gRPC services concurrently with custom interceptors.
• Prototyping gRPC integrations before committing to generated client code.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library that uses gRPC reflection to interact with gRPC services in a requests-like manner, supporting both synchronous and asynchronous calls with TLS and compression.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and offers genuine value for developers who want to call gRPC services without the overhead of code generation. Install friction is low. The main caveat is verifying protobuf and grpcio version compatibility for your specific Python version, particularly if using Python 3.13 or protobuf 4.25.4.

Install

grpc-requests on PyPI

pip install grpc-requests

uv add grpc-requests

poetry add grpc-requests

Installing grpc-requests

Before you install

Low friction installation with a pure-Python wheel. Actively maintained as of March 2025 with recent fixes for async iterators and dependency updates. Requires grpcio, protobuf, and cryptography; compatibility notes exist for protobuf 4.25.4 with grpcio >=1.66.0 and Python 3.13 support requires protobuf >=5.29.4.

License in practice

Apache License 2.0 is permissive, allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.

Quickstart

from grpc_requests import Client

client = Client.get_by_endpoint("localhost:50051")
response = client.request("helloworld.Greeter", "SayHello", {"name": "user"})

Requires a gRPC server with reflection enabled; Python >=3.9; protobuf version compatibility constraints exist for certain grpcio versions.

Verify before relying

• Whether lazy loading of services in async clients (added in 0.1.18) is production-ready or still experimental.
• Performance characteristics when working with large or deeply nested protobuf message types.
• How channel interceptors (added in 0.1.13) interact with custom message parsing (added in 0.1.17).

Package facts

Evidence: grpc_requests-0.1.21-py3-none-any.whl

Tags

More Python Modules packages