skillfed

xds-protos

Generated Python code from envoyproxy/data-plane-api

xds-protos v1.83.0 471.4K downloads/30d#6,481 on PyPI
Permissive license Apache-2.0 Active released

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-protos

uv

uv add xds-protos

poetry

poetry add xds-protos

Installing 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

Development Status :: 3 - AlphaProgramming Language :: PythonProgramming Language :: Python :: 3

Tags

xds protocol buffers pythonenvoy data plane api bindingsgrpc xds service stubscontrol plane proto definitionsenvoy service mesh protos
grpcservice-meshprotocol-buffers

More Internet packages