# 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](https://docs.airbyte.com/connector-development/connector-builder-ui/overview).
It should be enough for 90% connectors out there. For more flexible and complex connectors, use the
[low-code CDK and `SourceDeclarativeManifest`](https://docs.airbyte.com/connector-development/config-based/low-code-cdk-overview).
For more information on building connectors, please see the [Connector Development](https://docs.airbyte.com/connector-development/) guide on [docs.airbyte.com](https://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`](https://github.com/airbytehq/airbyte/tree/master/airbyte-integrations/connectors/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](docs/CONTRIBUTING.md).
## Release Management
Please see the [Release Management](docs/RELEASES.md) guide for information on how to perform releases and pre-releases.
Raw data
{
"_id": null,
"home_page": "https://airbyte.com",
"name": "airbyte-cdk",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "airbyte, connector-development-kit, cdk",
"author": "Airbyte",
"author_email": "contact@airbyte.io",
"download_url": "https://files.pythonhosted.org/packages/ad/b0/b16d9b915d5f5bcd33f0348863e847f8171dffa0a7692c3b5fe27f6b0b09/airbyte_cdk-6.60.12.tar.gz",
"platform": null,
"description": "# Airbyte Python CDK and Low-Code CDK\n\nAirbyte Python CDK is a framework for building Airbyte API Source Connectors. It provides a set of\nclasses and helpers that make it easy to build a connector against an HTTP API (REST, GraphQL, etc),\nor a generic Python source connector.\n\n## Building Connectors with the CDK\n\nIf you're looking to build a connector, we highly recommend that you first\n[start with the Connector Builder](https://docs.airbyte.com/connector-development/connector-builder-ui/overview).\nIt should be enough for 90% connectors out there. For more flexible and complex connectors, use the\n[low-code CDK and `SourceDeclarativeManifest`](https://docs.airbyte.com/connector-development/config-based/low-code-cdk-overview).\n\nFor more information on building connectors, please see the [Connector Development](https://docs.airbyte.com/connector-development/) guide on [docs.airbyte.com](https://docs.airbyte.com).\n\n## Python CDK Overview\n\nAirbyte CDK code is within `airbyte_cdk` directory. Here's a high level overview of what's inside:\n\n- `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`](https://github.com/airbytehq/airbyte/tree/master/airbyte-integrations/connectors/source-declarative-manifest) connector implementation instead.\n- `airbyte_cdk/cli/source_declarative_manifest`. This module defines the `source-declarative-manifest` (aka \"SDM\") connector execution logic and associated CLI.\n- `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.\n- `airbyte_cdk/models` expose `airbyte_protocol.models` as a part of `airbyte_cdk` package.\n- `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.\n- `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.\n- `airbyte_cdk/sources/file_based` is the CDK for file-based sources. Examples include S3, Azure, GCS, etc.\n\n## Contributing\n\nFor instructions on how to contribute, please see our [Contributing Guide](docs/CONTRIBUTING.md).\n\n## Release Management\n\nPlease see the [Release Management](docs/RELEASES.md) guide for information on how to perform releases and pre-releases.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A framework for writing Airbyte Connectors.",
"version": "6.60.12",
"project_urls": {
"Documentation": "https://docs.airbyte.io/",
"Homepage": "https://airbyte.com",
"Repository": "https://github.com/airbytehq/airbyte-python-cdk"
},
"split_keywords": [
"airbyte",
" connector-development-kit",
" cdk"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a745a5f8a34fa03b1ca79379621a52bff597336b4ec1caab494930abdbdd8a05",
"md5": "20ca65d28614ca0ffc820f6d9d657f91",
"sha256": "e6f37f8c6538d63c8d806e69a22b3f75792cecd1d450ce4b6c5912c445a8cfbe"
},
"downloads": -1,
"filename": "airbyte_cdk-6.60.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "20ca65d28614ca0ffc820f6d9d657f91",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 725765,
"upload_time": "2025-08-07T16:21:26",
"upload_time_iso_8601": "2025-08-07T16:21:26.206119Z",
"url": "https://files.pythonhosted.org/packages/a7/45/a5f8a34fa03b1ca79379621a52bff597336b4ec1caab494930abdbdd8a05/airbyte_cdk-6.60.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "adb0b16d9b915d5f5bcd33f0348863e847f8171dffa0a7692c3b5fe27f6b0b09",
"md5": "3ced5201258dda9480ef92fcfa9073d2",
"sha256": "20bdb1b94e49b269dec92e5c87cce0e7f63a54d46e4a804780aaf2279b3b662a"
},
"downloads": -1,
"filename": "airbyte_cdk-6.60.12.tar.gz",
"has_sig": false,
"md5_digest": "3ced5201258dda9480ef92fcfa9073d2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 510142,
"upload_time": "2025-08-07T16:21:29",
"upload_time_iso_8601": "2025-08-07T16:21:29.153243Z",
"url": "https://files.pythonhosted.org/packages/ad/b0/b16d9b915d5f5bcd33f0348863e847f8171dffa0a7692c3b5fe27f6b0b09/airbyte_cdk-6.60.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 16:21:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "airbytehq",
"github_project": "airbyte-python-cdk",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "airbyte-cdk"
}
JSON
