Installation
This page is for dltHub Feature, which requires a license. Join our early access program for a trial license.
dltHub currently supports Python versions 3.9-3.13.
Quickstart
To install the dlt[workspace] package, run:
pip install "dlt[workspace]"
This comes with the dlthub package. To use the features of dlthub, please get a valid license key 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
- macOS
- Windows
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
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
- macOS
- Windows
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
Install dlthub
dlthub will be automatically installed with workspace extra:
# install the newest dlt[workspace] version or upgrade the existing version to the newest one
uv pip install -U "dlt[workspace]"
Please install a valid license before proceeding, as described under licensing.
Licensing
To access dltHub’s paid features, such as Iceberg support or Python-based transformations, you need a dltHub Software License.
When you purchase a paid dltHub offering, the required license will be issued and managed automatically for your account.
You can also manually configure a license for local development or CI environments as shown below.
Applying your license
You can provide your license key in one of two ways:
In the secrets.toml file:
license = "your-dlthub-license-key"
As an environment variable
export DLT_LICENSE_KEY="your-dlthub-license-key"
Features requiring a license:
- @dlt.hub.transformation - powerful Python decorator to build transformation pipelines and notebooks
- dbt transformations: a staging layer for data transformations, combining a local cache with schema enforcement, debugging tools, and integration with existing data workflows.
- Iceberg support
- Secure data access and sharing
- AI workflows: agents to augment your data engineering team.
For more information about the feature scopes, see Scopes. Please also review our End User License Agreement (EULA)
Self-licensing
You can self-issue an anonymous 30-day trial license to explore dltHub’s paid features. This trial license is intended for development, education, and CI operations only. Self-issued licenses are bound to the specific machine on which they were created. They cannot be transferred or reused on other machines, workspaces, or environments.
See the Special Terms in our EULA for more details.
Issue a Trial License
Choose a scope for the feature you want to test, then issue a license with:
dlt license issue <scope>
This command will:
- Print your license key in the cli output
- License key will be put into your toml file
Scopes:
*: All featuresdlthub: All dltHub featuresdlthub.dbt_generator: Generate dbt packages from dlt pipelinesdlthub.sources.mssql: Change tracking for MSSQLdlthub.project: Declarative yaml interface for dltdlthub.transformation: Python-first query-agnostic data transformationsdlthub.destinations.iceberg: Iceberg destination with full catalog supportdlthub.destinations.snowflake_plus: Snowflake iceberg extension with Open Catalogdlthub.runner: Production pipeline runner and orchestrator support
You can self-issue multiple licenses; newly issued licenses will automatically include previously granted features.
To view your installed licenses:
dlt license info