Skip to content
Back to search

PyAirbyte

PyAirbyte brings the power of Airbyte to every Python developer. Powers the Airbyte Cloud Replication MCP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/airbytehq/PyAirbyte with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/airbytehq/PyAirbyte'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/airbytehq--pyairbyte/badge.svg)](/listings/airbytehq--pyairbyte)

HTML

<a href="/listings/airbytehq--pyairbyte"><img src="/api/listings/airbytehq--pyairbyte/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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`](https://docs.astral.sh/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.

For example, assuming PyAirbyte is running on Python 3.12, you can install a connector using Python 3.10.13 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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 115 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # PyAirbyte
  2. > [!IMPORTANT]
  3. > **`main` is patches-only.** The `release-candidate/v1` branch is the active trunk for new development.
  4. >
  5. > - **New features and enhancements:** branch from and target `release-candidate/v1`, not `main`. Only bug fixes and patches for the current release should target `main`.
  6. > - **Investigations and debugging:** check out `release-candidate/v1` to see the latest code. Changes merged to `main` are automatically synced into the release-candidate branch by the [RC Branch: Update from `main`](.github/workflows/rc-branch-update.yml) workflow.
  7. PyAirbyte brings the power of Airbyte to every Python developer. PyAirbyte provides a set of utilities to use Airbyte connectors in Python.
  8. [![PyPI version](https://badge.fury.io/py/airbyte.svg)](https://badge.fury.io/py/airbyte)
  9. [![PyPI - Downloads](https://img.shields.io/pypi/dm/airbyte)](https://pypi.org/project/airbyte/)
  10. [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/airbyte)](https://pypi.org/project/airbyte/)
  11. [![Star on GitHub](https://img.shields.io/github/stars/airbytehq/pyairbyte.svg?style=social&label=★%20on%20GitHub)](https://github.com/airbytehq/pyairbyte)
  12. ## Getting Started
  13. Watch this [Getting Started Loom video](https://www.loom.com/share/3de81ca3ce914feca209bf83777efa3f?sid=8804e8d7-096c-4aaa-a8a4-9eb93a44e850) or run one of our Quickstart tutorials below to see how you can use PyAirbyte in your python code.
  14. * [Basic Demo](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_Basic_Features_Demo.ipynb)
  15. * [CoinAPI](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_CoinAPI_Demo.ipynb)
  16. * [GA4](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_GA4_Demo.ipynb)
  17. * [Shopify](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_Shopify_Demo.ipynb)
  18. * [GitHub](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_Github_Incremental_Demo.ipynb)
  19. * [Postgres (cache)](https://github.com/airbytehq/quickstarts/blob/main/pyairbyte_notebooks/PyAirbyte_Postgres_Custom_Cache_Demo.ipynb)
  20. ## Airbyte MCP
  21. The [Airbyte MCP](https://docs.airbyte.com/platform/airbyte-mcp) is a [Model Context Protocol](https://modelcontextprotocol.io/) server that connects AI agents to your Airbyte organization. Your agent works with the same permissions you have in Airbyte. Use it with clients such as Claude, ChatGPT, and VS Code Copilot.
  22. With the Airbyte MCP, your agent can:
  23. * Build and manage pipelines: deploy sources and destinations, create connections, select streams, and start syncs.
  24. * Troubleshoot pipelines: check sync status, read job logs, and inspect connector configurations.
  25. * Read data directly: get live records from supported sources and query supported destinations without waiting for a sync.
  26. * Learn connector capabilities through connector skills, which describe supported entities, actions, and parameters.
  27. * Find answers in Airbyte's documentation and other Airbyte knowledge sources.
  28. Direct reads are read-only and only work with supported connectors after an organization admin enables the [context layer](https://docs.airbyte.com/platform/context-layer). They do not work with connectors whose secrets are stored in an external secrets manager.
  29. The hosted server works with all editions of Airbyte Cloud and Airbyte Flex. You can [run it locally with self-managed Airbyte Core](https://docs.airbyte.com/platform/airbyte-mcp/self-managed), but local deployments have known issues.
  30. To connect, use `https://mcp.airbyte.com/mcp` and sign in with your Airbyte Cloud account through OAuth. See the [installation instructions](https://docs.airbyte.com/platform/airbyte-mcp/install) and [complete tool list](https://docs.airbyte.com/platform/airbyte-mcp/tools).
  31. ## Connector Installation
  32. ### Declarative Source Installation
  33. 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.
  34. Declarative sources have the fastest download times, due to the simplicity and each of install.
  35. 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.
  36. ### Python Installation
  37. Generally, when Python-based installation is possible, it will be performed automatically given a Python-based connector name.
  38. 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.
  39. #### Installing Connectors with `uv`
  40. By default, beginning with version `0.29.0`, PyAirbyte defaults to [`uv`](https://docs.astral.sh/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.
  41. If you prefer to fall back to the prior `pip`-based installation methods, set the env var `AIRBYTE_NO_UV=true`.
  42. #### Installing Connectors With a Custom Python Version
  43. 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.
  44. For example, assuming PyAirbyte is running on Python 3.12, you can install a connector using Python 3.10.13 with the following code snippet:
  45. ```py
  46. import airbyte as ab
  47. source = ab.get_source(
  48. "source-faker",
  49. use_python="3.10.17",
  50. )
  51. ```
  52. ### Installing Connectors with Docker
  53. 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.
  54. ## Contributing
  55. To learn how you can contribute to PyAirbyte, please see our [PyAirbyte Contributors Guide](./docs/CONTRIBUTING.md).
  56. ## Frequently asked Questions
  57. **1. Does PyAirbyte replace Airbyte?**
  58. No. PyAirbyte is a Python library that allows you to use Airbyte connectors in Python, but it does not have orchestration
  59. or scheduling capabilities, nor does is provide logging, alerting, or other features for managing pipelines in
  60. production. Airbyte is a full-fledged data integration platform that provides connectors, orchestration, and scheduling capabilities.
  61. **2. What is the PyAirbyte cache? Is it a destination?**
  62. 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](https://docs.airbyte.com/integrations/destinations/).
  63. **3. Does PyAirbyte work with data orchestration frameworks like Airflow, Dagster, and Snowpark,**
  64. Yes, it should. Please give it a try and report any problems you see. Also, drop us a note if works for you!
  65. **4. Can I use PyAirbyte to develop or test when developing Airbyte sources?**
  66. Yes, you can. PyAirbyte makes it easy to test connectors in Python, and you can use it to develop new local connectors
  67. as well as existing already-published ones.
  68. **5. Can I develop traditional ETL pipelines with PyAirbyte?**
  69. Yes. Just pick the cache type matching the destination - like SnowflakeCache for landing data in Snowflake.
  70. **6. Can PyAirbyte import a connector from a local directory that has python project files, or does it have to be pip install**
  71. Yes, PyAirbyte can use any local install that has a CLI - and will automatically find connectors by name if they are on PATH.
  72. ## Changelog and Release Notes
  73. For a version history and list of all changes, please see our [GitHub Releases](https://github.com/airbytehq/PyAirbyte/releases) page.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.