---
id: envoy-data-plane
version: "2.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# envoy_data_plane — Python dataclasses for the Envoy Data-Plane-API

License: permissive · Maintenance: active · Downloads: 1.5M/mo

## What it is and what it does

envoy_data_plane is a Python library that wraps the Envoy Data-Plane-API protocol buffers as native Python dataclasses, generated using betterproto. It gives you type-safe, IDE-aware access to every Envoy API type without writing raw protobuf code. The library is intended for developers building Envoy control planes, configuration generators, or other tooling that needs to work with Envoy's configuration model programmatically.

The package depends only on betterproto2 and requires Python 3.11 or later. It is actively maintained and published to PyPI to track the current Envoy release. Common use cases include generating Envoy configurations via Python scripts, building custom control planes with IDE autocompletion, and laying groundwork for gRPC-based control planes in Python.

Use it for:

- Generate Envoy configuration files programmatically from Python, with type checking and IDE autocompletion.
- Build a custom Envoy control plane in Python with validated, strongly-typed configuration objects.
- Prototype or test Envoy configurations using Python scripts before deploying to production.
- Integrate Envoy configuration management into larger Python infrastructure-as-code workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python dataclasses for the Envoy Data-Plane-API, generated from protocol buffers using betterproto, enabling type-safe programmatic access to Envoy configuration types.

Yes, if you are building Envoy tooling or control planes in Python. The low install friction, active maintenance, MIT license, and single dependency make it a straightforward addition. No known vulnerabilities. The main caveat is verifying that the package version matches your target Envoy release, since it tracks the current Envoy version rather than maintaining branches for older releases.

## Install

pip install envoy-data-plane
uv add envoy-data-plane
poetry add envoy-data-plane

## Installing envoy_data_plane

Before you install: Low install friction with a single pure-Python dependency (betterproto2). Active maintenance with a recent release (24 days old), supporting Python 3.11+.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for proprietary and open-source projects alike.

Quickstart:

python -m pip install envoy_data_plane

from envoy_data_plane import config
# Import and use Envoy API types for configuration generation

Requires Python 3.11 or later

Verify before relying:

- Whether the package tracks all current Envoy releases or lags behind the latest XDS API versions
- IDE autocompletion quality and completeness of the generated dataclass types
- Performance characteristics when working with large or deeply nested configurations

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

envoy configuration python, envoy data plane api, envoy control plane library, envoy protobuf python, envoy xds types, envoy python dataclasses, envoy, control-plane, protobuf

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