Skip to main content

Airbyte CDK (Deprecated)

Note: AirbyteCDKLoader is deprecated. Please use AirbyteLoader instead.

Airbyte is a data integration platform for ELT pipelines from APIs, databases & files to warehouses & lakes. It has the largest catalog of ELT connectors to data warehouses and databases.

A lot of source connectors are implemented using the Airbyte CDK. This loader allows to run any of these connectors and return the data as documents.


First, you need to install the airbyte-cdk python package.

%pip install --upgrade --quiet  airbyte-cdk

Then, either install an existing connector from the Airbyte Github repository or create your own connector using the Airbyte CDK.

For example, to install the Github connector, run

%pip install --upgrade --quiet  "source_github@git+"

Some sources are also published as regular packages on PyPI


Now you can create an AirbyteCDKLoader based on the imported source. It takes a config object that's passed to the connector. You also have to pick the stream you want to retrieve records from by name (stream_name). Check the connectors documentation page and spec definition for more information on the config object and available streams. For the Github connectors these are:

from langchain_community.document_loaders.airbyte import AirbyteCDKLoader
from source_github.source import SourceGithub # plug in your own source here

config = {
# your github configuration
"credentials": {"api_url": "", "personal_access_token": "<token>"},
"repository": "<repo>",
"start_date": "<date from which to start retrieving records from in ISO format, e.g. 2020-10-20T00:00:00Z>",

issues_loader = AirbyteCDKLoader(
source_class=SourceGithub, config=config, stream_name="issues"
API Reference:AirbyteCDKLoader

Now you can load documents the usual way

docs = issues_loader.load()

As load returns a list, it will block until all documents are loaded. To have better control over this process, you can also you the lazy_load method which returns an iterator instead:

docs_iterator = issues_loader.lazy_load()

Keep in mind that by default the page content is empty and the metadata object contains all the information from the record. To create documents in a different, pass in a record_handler function when creating the loader:

from langchain_core.documents import Document

def handle_record(record, id):
return Document(["title"] + "\n" + (["body"] or ""),,

issues_loader = AirbyteCDKLoader(

docs = issues_loader.load()
API Reference:Document

Incremental loads

Some streams allow incremental loading, this means the source keeps track of synced records and won't load them again. This is useful for sources that have a high volume of data and are updated frequently.

To take advantage of this, store the last_state property of the loader and pass it in when creating the loader again. This will ensure that only new records are loaded.

last_state = issues_loader.last_state  # store safely

incremental_issue_loader = AirbyteCDKLoader(
source_class=SourceGithub, config=config, stream_name="issues", state=last_state

new_docs = incremental_issue_loader.load()

Was this page helpful?

You can also leave detailed feedback on GitHub.