{"id":9692,"library":"dlt-runtime","title":"dlt-runtime","description":"dlt-runtime provides the `dlt` command-line interface (CLI) for the `dlt` data loading library. It allows users to initialize, run, deploy, and manage data pipelines built with `dlt`. The current version is 0.24.1, and it follows the frequent release cadence of the main `dlt` library, often with multiple minor releases per month.","status":"active","version":"0.24.1","language":"en","source_language":"en","source_url":"https://github.com/dlt-hub/dlt","tags":["data loading","etl","cli","data pipeline","data engineering"],"install":[{"cmd":"pip install dlt-runtime","lang":"bash","label":"Install dlt-runtime"}],"dependencies":[{"reason":"The dlt-runtime package installs the `dlt` CLI which relies on the core `dlt` library for all data loading functionality.","package":"dlt","optional":false}],"imports":[{"note":"The `dlt-runtime` package provides the `dlt` CLI executable. For programmatic pipeline creation and data loading, you should `import dlt` from the `dlt` library itself (which `dlt-runtime` installs as a dependency). Do not try to import core `dlt` symbols directly from `dlt_runtime`.","wrong":"from dlt_runtime import pipeline","symbol":"pipeline","correct":"from dlt import pipeline"}],"quickstart":{"code":"# 1. Initialize a dlt project (e.g., using duckdb destination)\ndlt init duckdb_pipeline duckdb\n\n# 2. Navigate into the created project directory\ncd duckdb_pipeline\n\n# 3. Modify the pipeline script (e.g., duckdb_pipeline.py) if needed\n#    For example, to load data from a source:\n#    from dlt import pipeline, dlt_source\n#    from my_source import my_data_source\n#    \n#    @dlt_source\n#    def my_source():\n#        yield [1, 2, 3] # Replace with actual data loading\n#\n#    @pipeline(pipeline_name='duckdb_pipeline', destination='duckdb')\n#    def my_pipeline():\n#        my_source() # Load data from the source\n\n# 4. Run the pipeline\ndlt run duckdb_pipeline.py\n\n# 5. Check the status or deploy the pipeline\ndlt status","lang":"bash","description":"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."},"warnings":[{"fix":"Always use `from dlt import ...` for programmatic use of the `dlt` library. Use `dlt` command in your terminal for CLI operations.","message":"Common 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 ...`.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Refer 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.","message":"The `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.","severity":"breaking","affected_versions":"All versions, especially major/minor updates"},{"fix":"Ensure 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.","message":"Python 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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-17T00:00:00.000Z","next_check":"2026-07-16T00:00:00.000Z","problems":[{"fix":"Ensure `dlt-runtime` is installed (`pip install dlt-runtime`). If it is, verify your shell's PATH includes the Python `Scripts` or `bin` directory where `dlt` is installed. For virtual environments, ensure the environment is activated.","cause":"The `dlt-runtime` package, which installs the `dlt` CLI executable, was either not installed or not installed in an environment whose `bin` directory is on your system's PATH.","error":"dlt: command not found"},{"fix":"While `dlt-runtime` depends on `dlt`, ensure the `dlt` package itself is correctly installed. If you are importing, always use `from dlt import ...`. If the error persists, try reinstalling `pip install dlt` (which `dlt-runtime` will pull anyway).","cause":"You installed `dlt-runtime` and are trying to `import dlt` but the `dlt` core library might be missing or corrupted, or you're trying to import from `dlt_runtime` directly.","error":"ModuleNotFoundError: No module named 'dlt'"},{"fix":"Upgrade your Python version to a compatible one (e.g., 3.9, 3.10, 3.11, 3.12, 3.13, 3.14 but not 3.15+) or switch to a Python environment that satisfies these requirements. Using `pyenv` or `conda` can help manage multiple Python versions.","cause":"Your current Python environment does not meet the version requirements specified by the `dlt-runtime` package.","error":"ERROR: dlt-runtime has requirement Python '>=3.9.2,<3.15', but you have Python 3.8.10 which is incompatible."}]}