Installation

dlt+

This page is for dlt+, 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
sudo apt install python3.10-venv

macOS

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

brew update
brew install python@3.10

Windows

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

C:\> pip3 install -U pip

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 an ./env directory where your virtual environment will be stored:

python -m venv ./env

Activate the virtual environment:

source ./env/bin/activate

macOS

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

python -m venv ./env

Activate the virtual environment:

source ./env/bin/activate

Windows

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

C:\> python -m venv ./env

Activate the virtual environment:

C:\> .\env\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
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.