Install & Compatibility
Where this runs
tested against v0.26.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 27.9MB
glibcpy 3.10–3.910 runs
installs and imports cleanly · install 3.0s · import 0.000s · 28MB
26MB installed
● package 26MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
version
✓ from dlt_runtime import version
✗ from dlt_runtime import pipeline
This quickstart demonstrates how to use the `dlt` CLI (provided by `dlt-runtime`) to initialize, configure, and run a data loading pipeline. It uses `duckdb` as an example destination. Remember to adapt the pipeline script for your specific data sources.
# 1. Initialize a dlt project (e.g., using duckdb destination)
dlt init duckdb_pipeline duckdb
# 2. Navigate into the created project directory
cd duckdb_pipeline
# 3. Modify the pipeline script (e.g., duckdb_pipeline.py) if needed
# For example, to load data from a source:
# from dlt import pipeline, dlt_source
# from my_source import my_data_source
#
# @dlt_source
# def my_source():
# yield [1, 2, 3] # Replace with actual data loading
#
# @pipeline(pipeline_name='duckdb_pipeline', destination='duckdb')
# def my_pipeline():
# my_source() # Load data from the source
# 4. Run the pipeline
dlt run duckdb_pipeline.py
# 5. Check the status or deploy the pipeline
dlt status
dlt --version
Debug
Known issues
gotchaCommon confusion: `dlt-runtime` provides the `dlt` CLI command, while the core Python library for building pipelines is the `dlt` package. While `dlt-runtime` depends on `dlt`, programmatic imports for pipeline development should always be `from dlt import ...`, not `from dlt_runtime import ...`.fixAlways use `from dlt import ...` for programmatic use of the `dlt` library. Use `dlt` command in your terminal for CLI operations.
affects: All versions
breakingThe `dlt` ecosystem (and thus the `dlt` CLI provided by `dlt-runtime`) is under active development. Frequent releases may introduce breaking changes, especially in major or minor versions, related to destination configurations, pipeline resource definitions, or CLI command syntax.fixRefer to the official `dlt` documentation and release notes before upgrading, particularly for changes in `dlt` and related packages. Test your pipelines thoroughly after an upgrade.
affects: All versions, especially major/minor updates
gotchaPython version compatibility. `dlt-runtime` has specific Python version requirements (e.g., `>=3.9.2, <3.15` for version 0.24.1). Using an unsupported Python version will lead to installation or runtime errors.fixEnsure your Python environment meets the requirements specified on the PyPI page for `dlt-runtime`. Use a tool like `pyenv` or `conda` to manage Python versions if needed.
affects: All versions
Upgrade
Version history
0.26.1latest on PyPI · released Apr 28, 2026
Audit
Dependencies
dltrequiredThe dlt-runtime package installs the `dlt` CLI which relies on the core `dlt` library for all data loading functionality.