Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

PyAirbyte

PyAirbyte brings the power of Airbyte to every Python developer. PyAirbyte provides a set of utilities to use Airbyte connectors in Python.

PyPI version PyPI - Downloads PyPI - Python Version Star on GitHub

Getting Started

Watch this Getting Started Loom video or run one of our Quickstart tutorials below to see how you can use PyAirbyte in your python code.

Connector Installation

Declarative Source Installation

For Declarative Sources defined in YAML, the installation process will is to simply download the yaml file from the connectors.airbyte.com public URLs, and to run them directly as YAML.

Declarative sources have the fastest download times, due to the simplicity and each of install.

In some cases, you may get better stability by using docker_image=True in get_source()/get_destination(), due to the fact that all dependencies are locked within the docker image.

Python Installation

Generally, when Python-based installation is possible, it will be performed automatically given a Python-based connector name.

In some cases, you may get better stability by using docker_image=True in get_source()/get_destination(), due to the fact that all dependencies are locked within the docker image.

Installing Connectors with uv

By default, beginning with version 0.29.0, PyAirbyte defaults to uv instead of pip for Python connector installation. Compared with pip, uv is much faster. It also provides the unique ability of specifying different versions of Python than PyAirbyte is using, and even Python versions which are not already pre-installed on the local workstation.

If you prefer to fall back to the prior pip-based installation methods, set the env var AIRBYTE_NO_UV=true.

Installing Connectors With a Custom Python Version

In both get_source() and get_destination(), you can provide a use_python input arg that is equal to the desired version of Python that you with to use for the given connector. This can be helpful if an older connector doesn't support the version of Python that you are using for PyAirbyte itself.

PyAirbyte itself requires Python 3.11 or newer, but connectors can still be installed and run under older Python versions. For example, assuming PyAirbyte is running on Python 3.12, you can install a connector using Python 3.10.17 with the following code snippet:

import airbyte as ab

source = ab.get_source(
    "source-faker",
    use_python="3.10.17",
)

Installing Connectors with Docker

For any connector (get_source()/get_destination()), you can specify the docker_image argument to True to prefer Docker over other default installation methods or docker_image=MY_IMAGE to leverage a specific docker image tag for the execution.

Contributing

To learn how you can contribute to PyAirbyte, please see our PyAirbyte Contributors Guide.

Frequently asked Questions

1. Does PyAirbyte replace Airbyte? No. PyAirbyte is a Python library that allows you to use Airbyte connectors in Python, but it does not have orchestration or scheduling capabilities, nor does is provide logging, alerting, or other features for managing pipelines in production. Airbyte is a full-fledged data integration platform that provides connectors, orchestration, and scheduling capabilities.

2. What is the PyAirbyte cache? Is it a destination? Yes and no. You can think of it as a built-in destination implementation, but we avoid the word "destination" in our docs to prevent confusion with our certified destinations list here.

3. Does PyAirbyte work with data orchestration frameworks like Airflow, Dagster, and Snowpark, Yes, it should. Please give it a try and report any problems you see. Also, drop us a note if works for you!

4. Can I use PyAirbyte to develop or test when developing Airbyte sources? Yes, you can. PyAirbyte makes it easy to test connectors in Python, and you can use it to develop new local connectors as well as existing already-published ones.

5. Can I develop traditional ETL pipelines with PyAirbyte? Yes. Just pick the cache type matching the destination - like SnowflakeCache for landing data in Snowflake.

6. Can PyAirbyte import a connector from a local directory that has python project files, or does it have to be pip install Yes, PyAirbyte can use any local install that has a CLI - and will automatically find connectors by name if they are on PATH.

Changelog and Release Notes

For a version history and list of all changes, please see our GitHub Releases page.

Metadata

Release files for airbyte 1.0.0rc34.dev140839285966173

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 1.0.0rc34.dev140839285966173
File Size Uploaded Provenance
airbyte-1.0.0rc34.dev140839285966173.tar.gz 1.0 MB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for airbyte 1.0.0rc34.dev140839285966173
File Interpreter ABI Platform
airbyte-1.0.0rc34.dev140839285966173-py3-none-any.whl Python 3 none any Details

Total release size: 1.5 MB

Release files / airbyte-1.0.0rc34.dev140839285966173.tar.gz

Download URL airbyte-1.0.0rc34.dev140839285966173.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
da6c44b8b0a47abe57ae6d8e8950c52143f570df811a24cbded74ade6e0860cf
BLAKE2b-256 checksum
How to use checksums
208df028f9b0b94d80888e230a0d8d3a343ca514c4c7579cc15f62f66eaa19f4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / airbyte-1.0.0rc34.dev140839285966173-py3-none-any.whl

Download URL airbyte-1.0.0rc34.dev140839285966173-py3-none-any.whl
Size 506.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
96b99c5b30b363229aec16844906f603b0501125f8f1bf389c4adce3943a0b5f
BLAKE2b-256 checksum
How to use checksums
3f61ca4ac362bc42f2e2837a06ad45eebbb3690ece2630d9fa4f642462c1a87a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for airbyte 1.0.0rc34.dev140839285966173

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for airbyte-1.0.0rc34.dev140839285966173.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page