airbyte-connector-models

What it is and what it does

Airbyte Connector Models is a code-generation library that wraps Airbyte connector specifications into Pydantic models, enabling type-safe configuration and record handling in Python. It generates models nightly from the latest connector schemas, covering config specs for all source and destination connectors, record types for streams, and metadata used by the Airbyte Connector Registry. The package depends on airbyte-api, airbyte-cdk, pydantic, and requests, and is designed to integrate with the Airbyte ecosystem for end-to-end typed data pipelines.

The models preserve original field casing and support additional properties for fields not in the schema, providing ergonomic access to both standard and custom connector fields. It targets Python versions >=3.10,<3.13 and is actively maintained with frequent updates to track connector changes.

Use it for:

• Build type-checked Airbyte connector configurations in Python with IDE autocomplete and static type validation.
• Integrate Airbyte connectors into data pipelines while maintaining end-to-end type safety for configuration and records.
• Validate connector configurations before runtime by leveraging Pydantic's automatic validation on model instantiation.
• Access custom and undocumented connector fields ergonomically through Pydantic's additional properties support.
• Keep connector type definitions in sync with Airbyte's latest specifications through nightly model regeneration.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides automatically generated Pydantic models for type-safe configuration and record handling across all Airbyte connectors, with nightly updates to stay synchronized with connector specifications.

Yes. The package has low install friction, active maintenance, no known vulnerabilities, and a permissive MIT license. It solves a real problem—type safety for Airbyte connector configuration—and integrates cleanly with the Airbyte ecosystem. Install it if you use Airbyte connectors in Python and want IDE support and static type checking; note that record models are marked as planned functionality, so verify their availability for your use case.

Install

airbyte-connector-models on PyPI

pip install airbyte-connector-models

uv add airbyte-connector-models

poetry add airbyte-connector-models

Installing airbyte-connector-models

Before you install

Low install friction with a pure-Python wheel and four runtime dependencies (airbyte-api, airbyte-cdk, pydantic, requests). Package is actively maintained with a recent release.

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions, making it safe for both open-source and commercial projects.

Quickstart

pip install airbyte-connector-models

from airbyte_connector_models.connectors.postgres.source.config import SourcePostgresConfigSpec

config = SourcePostgresConfigSpec(
    host="localhost",
    port=5432,
    database="mydb",
    username="user",
    password="pass"
)

Requires Python >=3.10,<3.13; connector-specific model paths depend on which Airbyte connectors you need to configure.

Verify before relying

• Whether record models (noted as 'planned functionality') are fully available or still under development in version 0.1.9.
• The frequency and reliability of nightly model regeneration and how breaking schema changes are handled.
• Whether additional properties support works as documented for connectors with custom or undocumented fields.

Package facts

Evidence: airbyte_connector_models-0.1.9-py3-none-any.whl

Tags

More Database packages