---
id: grpc-requests
version: "0.1.21"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# grpc-requests — grpc for Humans. grpc reflection support client

License: permissive · Maintenance: active · Downloads: 189.2K/mo

## 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 above — 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

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

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 189.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

grpc client reflection, grpc python requests-like, grpc service discovery, grpc async client, grpc reflection client, grpc tls compression, grpc unary streaming, grpc-client, reflection-based, async-support

[View on SkillFed](https://skillfed.io/packages/grpc-requests) · [View on PyPI](https://pypi.org/project/grpc-requests/)