Skip to main content

Install from source

dbt Core and almost all of its adapter plugins are open source software. As such, the codebases are freely available to download and build from source. You might install form source if you want the latest code or want to install dbt from a specific commit. This might be helpful when you are contributing changes, or if you want to debug a past change.

To download form source, you would clone the repositories from GitHub, making a local copy, and then install the local version using pip.

Downloading and building dbt Core will enable you to contribute to the project by fixing a bug or implementing a sought-after feature. For more details, read the contributing guidelines.

Installing dbt Core

To install dbt-core from the GitHub code source:

git clone https://github.com/dbt-labs/dbt-core.git
cd dbt-core
pip install -r requirements.txt

This will install dbt-core and dbt-postgres. To install in editable mode (includes your local changes as you make them), use pip install -e editable-requirements.txt instead.

Installing adapter plugins

To install an adapter plugin from source, you will need to first locate its source repository. For instance, the dbt-redshift adapter is located at https://github.com/dbt-labs/dbt-redshift.git, so I can clone it and install from there:

git clone https://github.com/dbt-labs/dbt-redshift.git
cd dbt-redshift
pip install .

You do not need to install dbt-core before installing an adapter plugin -- the plugin includes dbt-core among its dependencies, and it will install the latest compatible version automatically.

To install in editable mode, such as while contributing, use pip install -e . instead.