yagrc
Yet another gRPC reflection client
Decision gist · record as of 2026-08-14
Yes, if your workflow involves calling gRPC services where pre-generating protobuf code is inconvenient or where you need runtime service discovery. The low install friction and active maintenance make it a practical choice. No, if you require the security guarantees and performance of compile-time code generation, or if you're working with security-sensitive applications—the documentation explicitly advises against reflection for those use cases.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- The target gRPC server must have server reflection enabled; yagrc cannot discover services from servers without reflection support.
- Low install friction: pure Python wheel with only three runtime dependencies (grpcio, grpcio_reflection, protobuf).
- Actively maintained with recent release on 2026-03-22.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
last release 2026-03-22 (145 days) · last repo commit 2026-03-22 · 5 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 95,278 downloads/mo, #13,274 on PyPI
Alternatives
Verify before relying
pip install yagrc
from yagrc import reflector as yagrc_reflector
reflector = yagrc_reflector.GrpcReflectionClient()
reflector.load_protocols(channel, symbols=["Arithmetic.Subtraction"])
stub_class = reflector.service_stub_class("Arithmetic.Subtraction")
request_class = reflector.message_class("Arithmetic.Minuend")- Whether the lazy importer is thread-safe for concurrent imports across multiple threads
- Performance characteristics when reflecting large or deeply nested proto schemas
- Compatibility with services using custom authentication or TLS configurations
What it is and what it does
Yagrc provides two main interfaces for working with gRPC services without running protoc. The reflector module lets you load protocol definitions from a gRPC server at runtime and retrieve service stubs and message classes by name; the importer module acts as a drop-in replacement for protoc-generated modules, allowing you to import them as if they were pre-generated, with the actual loading deferred until you connect to the server. Both rely on the server having gRPC reflection enabled.
The package is designed for situations where running protoc is inconvenient—such as when building a generic gRPC client, testing against services with evolving schemas, or working in environments where pre-generation isn't practical. It trades the safety and performance of compile-time code generation for runtime flexibility and reduced setup friction.
Use it for
- Build a generic gRPC client tool that works against any reflection-enabled service without pre-generating stubs
- Test or debug gRPC services during development without regenerating code after proto changes
- Dynamically call gRPC services from scripts or tools where protoc integration is impractical
- Create a gRPC gateway or proxy that forwards calls to multiple backend services discovered via reflection
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if your workflow involves calling gRPC services where pre-generating protobuf code is inconvenient or where you need runtime service discovery.
The low install friction and active maintenance make it a practical choice. No, if you require the security guarantees and performance of compile-time code generation, or if you're working with security-sensitive applications—the documentation explicitly advises against reflection for those use cases.
Install
yagrc on PyPI
Before you install
Low install friction: pure Python wheel with only three runtime dependencies (grpcio, grpcio_reflection, protobuf). Actively maintained with recent release on 2026-03-22.
The target gRPC server must have server reflection enabled; yagrc cannot discover services from servers without reflection support.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install yagrc
from yagrc import reflector as yagrc_reflector
reflector = yagrc_reflector.GrpcReflectionClient()
reflector.load_protocols(channel, symbols=["Arithmetic.Subtraction"])
stub_class = reflector.service_stub_class("Arithmetic.Subtraction")
request_class = reflector.message_class("Arithmetic.Minuend")Verify before relying
- Whether the lazy importer is thread-safe for concurrent imports across multiple threads
- Performance characteristics when reflecting large or deeply nested proto schemas
- Compatibility with services using custom authentication or TLS configurations
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesgrpciogrpcio_reflectionprotobuf |
| Maintenance | Actively maintained 145 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 95,278 / month, #13,274 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3Topic :: Software Development :: Libraries :: Python Modules |
Evidence: yagrc-1.1.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “grpc reflection client python”
- yagrcYagrc is a gRPC reflection client that lets you call gRPC services…
- grpcio-reflectionEnables gRPC Python services to expose runtime reflection of their…
- grpc-requestsA Python client library that uses gRPC reflection to interact with…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also grpc-requests · grpcio-reflection · grpclib · aristaproto · types-grpcio-reflection · clarifai-grpc · grpc-interceptor · grpcio-admin · protoc-wheel-0 · grpcio-channelz