grpcio-csds
xDS configuration dump library
Decision gist · record as of 2026-08-14
Yes, if you need to inspect or debug xDS configuration in gRPC applications. Low install friction, permissive license, active maintenance, and no known vulnerabilities make it a safe choice. Not necessary if you don't use xDS or don't need programmatic access to configuration state.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later
- Low friction: pure Python wheel with only three runtime dependencies (protobuf, xds-protos, grpcio).
- Actively maintained with a release 22 days ago.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.
last release 2026-07-23 (22 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 78,962 downloads/mo, #14,389 on PyPI
Alternatives
Verify before relying
pip install grpcio-csds
import grpc_csds
# Use with grpcio and protobuf to access xDS configuration state- Performance characteristics when dumping large xDS configurations
- Compatibility with non-Envoy xDS implementations
- Whether grpcdebug CLI tool is bundled or requires separate installation
What it is and what it does
grpcio-csds is a Python library that implements the Client Status Discovery Service (CSDS) from the Envoy xDS protocol. It lets gRPC applications programmatically expose and inspect the traffic configuration they have received from xDS control planes—essentially providing a window into what xDS resources a gRPC client has loaded. This is useful for debugging, monitoring, and verifying that your gRPC application has the correct configuration state.
The package depends on protobuf, xds-protos, and grpcio, and requires Python 3.10 or later. It is actively maintained with no known security vulnerabilities and carries a permissive Apache-2.0 license.
Use it for
- Debug gRPC application configuration state by querying received xDS resources programmatically
- Monitor and verify that traffic policies and service discovery updates have been applied correctly
- Build custom tooling to inspect configuration state in gRPC deployments
- Integrate configuration discovery into observability or compliance workflows
- Validate control plane behavior by reading back what clients have actually received
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to inspect or debug xDS configuration in gRPC applications.
Low install friction, permissive license, active maintenance, and no known vulnerabilities make it a safe choice. Not necessary if you don't use xDS or don't need programmatic access to configuration state.
Install
grpcio-csds on PyPI
Before you install
Low friction: pure Python wheel with only three runtime dependencies (protobuf, xds-protos, grpcio). Actively maintained with a release 22 days ago.
Requires Python 3.10 or later
License in practice
Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.
Quickstart
pip install grpcio-csds
import grpc_csds
# Use with grpcio and protobuf to access xDS configuration stateVerify before relying
- Performance characteristics when dumping large xDS configurations
- Compatibility with non-Envoy xDS implementations
- Whether grpcdebug CLI tool is bundled or requires separate installation
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesprotobufxds-protosgrpcio |
| Maintenance | Actively maintained 22 days since the last release |
| First released | |
| Downloads | 78,962 / month, #14,389 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/StableProgramming Language :: PythonProgramming Language :: Python :: 3 |
Evidence: grpcio_csds-1.83.0-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 xds configuration discovery”
- grpcio-csdsExposes received xDS traffic configuration from gRPC applications…
- xds-protosProvides Python bindings for xDS protocol buffer definitions,…
- grpcio-adminExposes debugging and monitoring services for gRPC applications,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also grpcio-admin · xds-protos · grpcio-reflection · envoy_data_plane · py-grpc-prometheus · grpc-interceptor · nacos-sdk-python · grpcio-status · grpcio-health-checking · PyChromecast