---
id: airbyte-connector-models
version: "0.1.9"
license: MIT
license_treatment: permissive
maintenance: active
---

# airbyte-connector-models — Typed Pydantic models for Airbyte connectors

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

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

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

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

## Tags

airbyte connector type models, pydantic models for airbyte, typed airbyte configuration, airbyte connector schemas, airbyte record models, type-safe connector config, type-safety, data-integration, connector-models

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