xds-protos
Generated Python code from envoyproxy/data-plane-api
What it is and what it does
xds-protos is a collection of pre-generated Python code from the data-plane-api protocol buffer definitions. It provides ready-to-import message types and gRPC service stubs for the xDS family of APIs, which are used by control planes to dynamically configure proxies and manage service discovery.
The package is maintained as part of the gRPC project and eliminates the need to manually compile proto files for common xDS use cases, offering a straightforward import path based on proto package hierarchy. It depends on grpcio and protobuf, both standard gRPC ecosystem libraries. The package supports current Python versions and requires Python >= 3.10.
Use it for:
- Building gRPC clients that communicate with Envoy control planes using xDS protocol definitions.
- Implementing custom xDS control plane services that manage Envoy proxy configurations.
- Integrating service mesh tooling that relies on xDS APIs for dynamic service discovery.
- Testing xDS-based deployments without manually compiling proto files.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides Python bindings for xDS protocol buffer definitions, enabling gRPC service stubs and message types for xDS-based control planes.
Yes, if you are building or integrating with xDS-based control planes or service mesh tooling. The package is actively maintained, has low install friction, carries a permissive Apache-2.0 license, and eliminates proto compilation overhead. Not relevant for projects that do not interact with xDS APIs.
Install
xds-protos on PyPI
pip
pip install xds-protosuv
uv add xds-protospoetry
poetry add xds-protosInstalling xds-protos
Before you install
Low friction install with active maintenance. Released within the last month. Depends only on grpcio and protobuf, both widely-used foundational libraries.
License in practice
Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution.
Quickstart
pip install xds-protos
from envoy.service.status.v3 import csds_pb2
from envoy.service.status.v3 import csds_pb2_grpc
Requires Python >= 3.10
Verify before relying
- Whether this package tracks upstream data-plane-api changes automatically or requires manual synchronization.
- Compatibility guarantees or stability commitments across xDS API versions.
- Whether the Alpha development status indicates API stability or ongoing breaking changes.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 2 — grpcio, protobuf |
| Maintenance | actively maintained — 22 days since the last release |
| First released | |
| Downloads | 471,450/month — #6,481 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: xds_protos-1.83.0-py3-none-any.whl
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
envoy_data_planeProvides Python dataclasses for the Envoy…
permissive · top 5,000 on PyPI
grpcio-csdsExposes received xDS traffic configuration from…
permissive · top 15,000 on PyPI
opensearch-protobufsProvides pre-generated Python Protocol Buffer…
permissive · top 5,000 on PyPI
hatch-protobufA Hatch build plugin that generates Python…
copyleft · top 15,000 on PyPI
sentry-protosProvides protocol buffer and gRPC schema…
unclear · top 15,000 on PyPI
flyteidlFlyteidl provides the protobuf-based IDL…
permissive · top 15,000 on PyPI
aristaprotoGenerates Python gRPC stubs and message classes…
permissive · top 15,000 on PyPI
grpcio-toolsGenerates Python gRPC service stubs and message…
permissive · top 1,000 on PyPI
betterproto-fwGenerates idiomatic Python code from Protobuf 3…
permissive · top 15,000 on PyPI
betterprotoGenerates idiomatic Python code from Protobuf 3…
permissive · top 5,000 on PyPI