Skip to content

Install

1. Download binaries

Download skippr-dbt and skippr for your platform from the releases page.

Binary Purpose
skippr-dbt Pipeline orchestrator -- the main CLI you interact with
skippr (v6.15.0+) Extract-and-load engine (invoked automatically by skippr-dbt)

Place both on your PATH and verify:

skippr-dbt --version
skippr --version

2. Install Python and dbt

Python 3.10+ is required to run dbt, which skippr-dbt uses for model compilation and materialisation.

python3 -m venv .venv
source .venv/bin/activate        # macOS / Linux
# .\.venv\Scripts\Activate.ps1   # Windows PowerShell

pip install --upgrade pip
pip install dbt-core

Then install the adapter for your warehouse:

Warehouse Adapter
Snowflake pip install dbt-snowflake
BigQuery pip install dbt-bigquery

Verify:

dbt --version

The virtual environment must be activated whenever you run skippr-dbt.

3. Set up your LLM API key

Skippr dbt uses an LLM to assist with schema mapping and model generation. Set your API key:

export LLM_API_KEY="sk-..."

4. Configure credentials

Warehouse and source credentials are set as environment variables. See the connect guide for your specific provider:

Next steps

Head to the Quick Start to initialise your first project.