---
id: airbyte-protocol-models-pdv2
version: "0.18.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# airbyte-protocol-models-pdv2 — Declares the Airbyte Protocol.

License: permissive · Maintenance: aging · Downloads: 286.0K/mo

## What it is and what it does

airbyte-protocol-models-pdv2 is a Python package that declares and implements the Airbyte Protocol—the standard message format used by Airbyte data integration connectors to communicate. It provides serializable data models built on pydantic, allowing connectors and integration tools to construct, validate, and exchange protocol-compliant messages. The package is part of Airbyte's core infrastructure and is typically used as a dependency rather than directly in application code.

The package supports Python 3.9 and later, has low install friction (only pydantic as a runtime dependency), and is distributed as a wheel. While the project repository remains active, the package itself has not seen a release in over a year, suggesting it may be in a stable or maintenance-only state rather than under active feature development.

Use it for:

- Building custom Airbyte connectors that need to emit protocol-compliant messages to the Airbyte platform.
- Integrating with Airbyte's data pipeline infrastructure where protocol message validation is required.
- Testing or debugging Airbyte connector behavior by constructing and inspecting protocol messages locally.
- Developing tooling or utilities that need to parse or generate Airbyte Protocol messages.

## Worth the install?

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

Provides Python models and serialization for the Airbyte Protocol, enabling data integration connectors to communicate using Airbyte's standard message format.

Yes, if you are building or extending Airbyte connectors or integrations that require protocol-compliant message handling. The permissive MIT license, low dependency footprint, and stable API make it safe to adopt. However, the 413-day release gap warrants checking whether active development continues or whether you need to pin to version 0.18.0 for stability. Not necessary for users simply running Airbyte connectors.

## Install

pip install airbyte-protocol-models-pdv2
uv add airbyte-protocol-models-pdv2
poetry add airbyte-protocol-models-pdv2

## Installing airbyte-protocol-models-pdv2

Before you install: Low install friction with a single dependency on pydantic. Maintenance status is aging—last release was 413 days ago, though the repository remains active with recent commits as of 2026-01-27.

License in practice: MIT license is permissive and places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install airbyte-protocol-models-pdv2

from airbyte_protocol_models_pdv2 import AirbyteMessage

message = AirbyteMessage(...)

Requires Python 3.9 or later.

Verify before relying:

- Whether the package is actively maintained or in maintenance-only mode despite the 413-day gap since last release.
- What specific protocol versions this package supports and whether it handles backward compatibility.
- Whether this package is intended for direct use or primarily as a dependency for Airbyte connectors.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 286.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airbyte protocol models, airbyte message serialization, data integration protocol, airbyte connector communication, protocol data structures, data-integration, protocol-models

[View on SkillFed](https://skillfed.io/packages/airbyte-protocol-models-pdv2) · [View on PyPI](https://pypi.org/project/airbyte-protocol-models-pdv2/)