Installation

dltHub

This page is for dltHub Feature, which requires a license. Join our early access program for a trial license.

Supported Python versions

dlt+ currently supports Python versions 3.9-3.12.

Quickstart

To install the dlt-plus package, run:

pip install dlt-plus

Please install a valid license before proceeding, as described under licensing.

Setting up your environment

Configuration of the Python environment

Check if your Python environment is configured:

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.

Ubuntu

You can install Python 3.10 with apt.

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

macOS

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

brew update
brew install python@3.10
pip install uv

Windows

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

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

Virtual environment

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.

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

macOS

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

Windows

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

Install dlt+

You can now install dlt+ in your virtual environment by running:

# install the newest dlt version or upgrade the existing version to the newest one
uv pip install -U dlt-plus

Please install a valid license before proceeding, as described under licensing.

Licensing

Once you have a valid license, you can make it available to dlt+ using one of the following methods:

1. Environment variable: set the license key as an environment variable:

export RUNTIME__LICENSE="eyJhbGciOiJSUz...vKSjbEc==="

2. Secrets file: add the license key to a secrets.toml file. You can use either the project-level secrets.toml (located in ./.dlt/secrets.toml) or the global one (located in ~/.dlt/secrets.toml):

[runtime]
license="eyJhbGciOiJSUz...vKSjbEc==="

3. dlt.yml: add the license key directly in the project manifest file referencing a user-defined environment variable:

runtime:
  license: { env.MY_ENV_CONTAINING_LICENSE_KEY }

You can verify that the license was installed correctly and is valid by running:

$ dlt license show

Our license terms can be found here.