---
id: grpcio-reflection
version: "1.83.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# grpcio-reflection — Standard Protobuf Reflection Service for gRPC

License: permissive · Maintenance: active · Downloads: 9.9M/mo

## What it is and what it does

grpcio-reflection is the standard reflection service implementation for gRPC Python. It allows a running gRPC server to expose metadata about its service definitions—the available RPC methods, their input and output message types, and other schema information—so that clients can dynamically discover and call methods without having the .proto files or generated stubs in advance.

The package is a thin wrapper around protobuf reflection capabilities, designed to integrate directly into grpcio servers. It depends on grpcio and protobuf as runtime dependencies and is maintained as part of the official gRPC project. It's classified as production-stable and actively maintained, with support for current Python versions.

Use it for:

- Build dynamic gRPC clients that discover service methods at runtime without pre-generated stubs.
- Enable interactive gRPC debugging tools and CLI utilities that need to introspect live services.
- Support polyglot environments where clients in different languages need to query a Python gRPC service schema.
- Implement gRPC API gateways or proxies that route calls based on dynamically discovered method signatures.
- Create testing frameworks that validate gRPC services by reflecting on their available endpoints.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Enables gRPC Python services to expose runtime reflection of their service definitions, allowing clients to discover available methods and message types without prior knowledge of the service schema.

Yes. This is the standard reflection implementation for gRPC Python, maintained as part of the official project, with low install friction and no known vulnerabilities. Install it if you need clients to discover gRPC service methods dynamically or if you're building tooling that requires runtime introspection of gRPC schemas.

## Install

pip install grpcio-reflection
uv add grpcio-reflection
poetry add grpcio-reflection

## Installing grpcio-reflection

Before you install: Low friction install with only two runtime dependencies (grpcio and protobuf). Active maintenance with a release 22 days ago. Supports modern Python versions from 3.10 through 3.14.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install grpcio-reflection

from grpcio_reflection.v1 import reflection

reflection.enable_server_reflection(server)

Requires grpcio and protobuf to be installed; Python 3.10 or later.

Verify before relying:

- Whether reflection service adds measurable latency or memory overhead to running gRPC servers.
- Support for reflection of custom service extensions or non-standard protobuf message types.

## Package facts

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

## Tags

grpc reflection service, grpc service discovery, protobuf reflection python, grpc introspection, grpc method discovery, grpc dynamic client, grpc schema reflection, grpc, reflection, service-discovery

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