---
id: xds-protos
version: "1.83.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# xds-protos — Generated Python code from envoyproxy/data-plane-api

License: permissive · Maintenance: active · Downloads: 471.4K/mo

## 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 above — 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

pip install xds-protos
uv add xds-protos
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_current
- Install friction: low
- Maintenance: active
- Downloads: 471.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

xds protocol buffers python, envoy data plane api bindings, grpc xds service stubs, control plane proto definitions, envoy service mesh protos, grpc, service-mesh, protocol-buffers

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