Installation#

Setting up your environment#

1. Make sure you are using Python 3.9-3.13 and have pip installed#

python --version
pip --version

If you have a different Python version installed or are missing pip, follow the instructions below to update your Python version and/or install pip.

<Tabs values={[{"label": "Ubuntu", "value": "ubuntu"}, {"label": "macOS", "value": "macos"}, {"label": "Windows", "value": "windows"}]} groupId="operating-systems" defaultValue="ubuntu">

You can install Python 3.10 with apt.

sudo apt update
sudo apt install python3.10
pip install uv

On macOS, you can use Homebrew to install Python 3.10.

brew update
brew install python@3.10
pip install uv

After installing Python 3.10 (64-bit version) for Windows, you can install pip.

C:\> pip3 install -U pip
C:\> pip3 install uv

2. Set up and activate a virtual environment for your Python project#

We recommend working within a virtual environment when creating Python projects.
This way, all the dependencies for your current project will be isolated from packages in other projects.

<Tabs values={[{"label": "Ubuntu", "value": "ubuntu"}, {"label": "macOS", "value": "macos"}, {"label": "Windows", "value": "windows"}]} groupId="operating-systems" defaultValue="ubuntu">

Create a new virtual environment in your working folder. This will create a ./venv directory where your virtual environment will be stored:

uv venv --python 3.10

Activate the virtual environment:

source .venv/bin/activate

Create a new virtual environment in your working folder. This will create a ./venv directory where your virtual environment will be stored:

uv venv --python 3.10

Activate the virtual environment:

source .venv/bin/activate

Create a new virtual environment in your working folder. This will create a ./venv directory where your virtual environment will be stored:

C:\> uv venv --python 3.10

Activate the virtual environment:

C:\> .\venv\Scripts\activate

3. Install dlt library#

To install or upgrade to the newest version of dlt in your virtual environment, run:

uv pip install -U dlt

Here are some additional installation examples:

To install dlt with DuckDB support:

uv pip install "dlt[duckdb]"

To install a specific version of dlt (for example, versions before 0.5.0):

uv pip install "dlt<0.5.0"

3.1. Install dlt via Pixi or Conda#

To install dlt using pixi:

pixi add dlt

To install dlt using conda:

conda install -c conda-forge dlt

4. Done!#

You are now ready to build your first pipeline with dlt. Check out these tutorials to get started:

• Load data from a REST API
• Load data from a SQL database
• Load data from a cloud storage or a file system

Or read a more detailed tutorial on how to build a custom data pipeline with dlt.