Airbyte Python CDK and Low-Code CDK

Airbyte Python CDK is a framework for building Airbyte API Source Connectors. It provides a set of classes and helpers that make it easy to build a connector against an HTTP API (REST, GraphQL, etc), or a generic Python source connector.

Building Connectors with the CDK

If you're looking to build a connector, we highly recommend that you first start with the Connector Builder. It should be enough for 90% connectors out there. For more flexible and complex connectors, use the low-code CDK and SourceDeclarativeManifest.

For more information on building connectors, please see the Connector Development guide on docs.airbyte.com.

Python CDK Overview

Airbyte CDK code is within airbyte_cdk directory. Here's a high level overview of what's inside:

airbyte_cdk/connector_builder. Internal wrapper that helps the Connector Builder platform run a declarative manifest (low-code connector). You should not use this code directly. If you need to run a SourceDeclarativeManifest, take a look at source-declarative-manifest connector implementation instead.
airbyte_cdk/cli/source_declarative_manifest. This module defines the source-declarative-manifest (aka "SDM") connector execution logic and associated CLI.
airbyte_cdk/destinations. Basic Destination connector support! If you're building a Destination connector in Python, try that. Some of our vector DB destinations like destination-pinecone are using that code.
airbyte_cdk/models expose airbyte_protocol.models as a part of airbyte_cdk package.
airbyte_cdk/sources/concurrent_source is the Concurrent CDK implementation. It supports reading data from streams concurrently per slice / partition, useful for connectors with high throughput and high number of records.
airbyte_cdk/sources/declarative is the low-code CDK. It works on top of Airbyte Python CDK, but provides a declarative manifest language to define streams, operations, etc. This makes it easier to build connectors without writing Python code.
airbyte_cdk/sources/file_based is the CDK for file-based sources. Examples include S3, Azure, GCS, etc.

Contributing

For instructions on how to contribute, please see our Contributing Guide.

Release Management

Please see the Release Management guide for information on how to perform releases and pre-releases.

Metadata

Release files for airbyte-cdk 7.10.2.post31.dev22785446959

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for airbyte-cdk 7.10.2.post31.dev22785446959
File	Size	Uploaded
airbyte_cdk-7.10.2.post31.dev22785446959.tar.gz	552.5 kB	Mar 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for airbyte-cdk 7.10.2.post31.dev22785446959
File	Interpreter	ABI	Platform	Reset
airbyte_cdk-7.10.2.post31.dev22785446959-py3-none-any.whl 780.6 kB Mar 6, 2026	Python 3	none	any	Details

Total release size: 1.3 MB

Release files / airbyte_cdk-7.10.2.post31.dev22785446959.tar.gz

Download URL	airbyte_cdk-7.10.2.post31.dev22785446959.tar.gz
Size	552.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`bcef66ea6ea046763713c151a0c78e04cc0b52d86f15091a485dbd571ade8377`
BLAKE2b-256 checksum How to use checksums	`acaafe6b31af2074b312d869793a58056537c09b0e81c6e49201c6ee5cee6a74`
Upload date	Mar 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.8`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/airbytehq/airbyte-python-cdk
Publishing commit: github.com/airbytehq/airbyte-python-cdk/tree/b0537da95b9e25a70bcbf6e3cafe2d7b88e23907

Workflow

Publishing configuration: github.com/airbytehq/airbyte-python-cdk/blob/b0537da95b9e25a70bcbf6e3cafe2d7b88e23907/.github/workflows/publish.yml
Publishing logs: github.com/airbytehq/airbyte-python-cdk/actions/runs/22785446959/attempts/1

Artifact

Subject: airbyte_cdk-7.10.2.post31.dev22785446959.tar.gz
SHA-256 checksum: bcef66ea6ea046763713c151a0c78e04cc0b52d86f15091a485dbd571ade8377 Verifying attestations

Release files / airbyte_cdk-7.10.2.post31.dev22785446959-py3-none-any.whl

Download URL	airbyte_cdk-7.10.2.post31.dev22785446959-py3-none-any.whl
Size	780.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`17f1959ab3d3b26e4c7d5bd740ad236a94e9e7ef8bd03e51d0b54128f5135cd2`
BLAKE2b-256 checksum How to use checksums	`daae9c23115c708ba8116fa4229f52f4f3dd6d9ba1d56b4209044c98847bfc2d`
Upload date	Mar 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.8`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/airbytehq/airbyte-python-cdk
Publishing commit: github.com/airbytehq/airbyte-python-cdk/tree/b0537da95b9e25a70bcbf6e3cafe2d7b88e23907

Workflow

Publishing configuration: github.com/airbytehq/airbyte-python-cdk/blob/b0537da95b9e25a70bcbf6e3cafe2d7b88e23907/.github/workflows/publish.yml
Publishing logs: github.com/airbytehq/airbyte-python-cdk/actions/runs/22785446959/attempts/1

Artifact

Subject: airbyte_cdk-7.10.2.post31.dev22785446959-py3-none-any.whl
SHA-256 checksum: 17f1959ab3d3b26e4c7d5bd740ad236a94e9e7ef8bd03e51d0b54128f5135cd2 Verifying attestations