Registry / workflow / dbnd
library1.0.34.1pypypi✓ verified 86d ago

Databand (dbnd) is a Python library for MLOps, providing orchestration, monitoring, and debugging capabilities for data pipelines. It allows users to define ML tasks and pipelines, track metadata, and integrate with orchestrators like Apache Airflow. The current version is 1.0.34.1, with releases occurring periodically, though core independent development appears to have slowed following an acquisition by IBM.

pip install dbnd
INSTALL
IMPORT
SIG · DBND
D
dbnd
workflowpythonv1.0.34.1
Install
4.7s avg
Import
1772ms
Disk
51MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.0.34.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
musl
py 3.103.920 runs
installs and imports cleanly · install 0.0s · import 1.844s · 50.6MB
glibc
py 3.103.920 runs
installs and imports cleanly · install 4.7s · import 1.701s · 52MB
51MB installed
● package 51MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

task
from dbnd import task
pipeline
from dbnd import pipeline
dbnd_context
from dbnd import dbnd_context
band
from dbnd import band

This quickstart defines a simple ML pipeline with two tasks using Databand's decorators. It configures the library to output tracking information to the console and demonstrates how to run a pipeline programmatically using `dbnd_context`. For full tracking, a Databand tracking server URL and API key would typically be configured via environment variables or a `dbnd.cfg` file.

import os from dbnd import task, pipeline, dbnd_context # Configure DBND to log to console for demonstration # In a real scenario, you'd typically integrate with a Databand tracking server os.environ['DBND__CORE__TRACKER'] = 'console' # Ensure console logging is enabled os.environ['DBND__CORE__DATABAND_URL'] = os.environ.get('DATABAND_URL', 'http://localhost:8080') # Placeholder os.environ['DBND__CORE__DATABAND_ACCESS_TOKEN'] = os.environ.get('DATABAND_ACCESS_TOKEN', 'YOUR_API_KEY') # Placeholder @task def calculate_alpha(alpha: float) -> float: print(f"Alpha is: {alpha}") return alpha * 2 @pipeline def alpha_pipeline() -> float: val1 = calculate_alpha(alpha=1.0) val2 = calculate_alpha(alpha=val1) return val2 if __name__ == "__main__": # Using dbnd_context to ensure configuration is applied for programmatic runs with dbnd_context(conf={"core": {"tracker": ["console"]}}): result = alpha_pipeline() print(f"\nPipeline finished with result: {result}") print("\nTo run via CLI with full tracking (if configured): dbnd run alpha_pipeline")
dbnd --version
Debug
Known issues
gotchaThe `dbnd` library is currently in maintenance mode, with primary development efforts likely redirected towards IBM's enterprise MLOps offerings (Watsonx.data). While actively maintained, independent feature development may be limited.
fix
Be aware that community support and independent feature velocity might be lower compared to actively developed open-source projects. Ensure your deployment aligns with expected long-term support plans.
affects: 1.x.x
gotchaFull integration with orchestrators like Apache Airflow requires installing the optional `dbnd[airflow]` extra package, which adds necessary dependencies and plugins.
fix
If using Airflow, install with `pip install dbnd[airflow]` to ensure all integration components are available.
affects: All 1.x.x
gotchaDataband's configuration system allows settings via environment variables (e.g., `DBND__CORE__TRACKER`), `dbnd.cfg` files, and programmatic `dbnd_context`. Inconsistent or missing configuration can lead to jobs not being tracked or failing.
fix
Establish a clear configuration strategy. For production, centralize settings in `dbnd.cfg` or environment variables. For programmatic local runs, use `dbnd_context` for specific overrides.
affects: All 1.x.x
gotchaRunning `dbnd` pipelines can be done either directly as Python scripts (wrapped in `dbnd_context`) or via the `dbnd run <pipeline_name>` CLI command. The CLI provides more robust control over execution and integration with tracking.
fix
For basic local testing or programmatic embedding, direct Python execution is fine. For production or complex orchestrations, prefer the `dbnd run` CLI as it leverages `dbnd`'s full configuration and orchestrator integration capabilities.
affects: All 1.x.x
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'dbnd_airflow'
Attempting to use Databand features designed for Apache Airflow integration without installing the `dbnd-airflow` package (part of the `dbnd[airflow]` extra).
fix
Install the Airflow integration package: `pip install dbnd[airflow]`
No tracking server configured and console tracking is disabled. To enable console tracking, add "dbnd__core__tracker=console" to your configuration.
Databand requires a tracking method (e.g., a remote server API or local console logging) to be explicitly configured. This error indicates neither was found.
fix
Enable console tracking via an environment variable: `export DBND__CORE__TRACKER=console` or by creating a `dbnd.cfg` file with `[core]
tracker=console`.
Cannot connect to Databand tracking server at <URL>. Please check your network connection and server availability. (Error: HTTPConnectionPool...)
The `DBND__CORE__DATABAND_URL` is incorrectly set, the tracking server is not running, or there's a network connectivity issue preventing `dbnd` from reaching it.
fix
Verify the `DBND__CORE__DATABAND_URL` and `DBND__CORE__DATABAND_ACCESS_TOKEN` environment variables or `dbnd.cfg` settings. Ensure the Databand tracking server is operational and accessible from your environment.
Upgrade
Version history
1.0.34.1latest on PyPI · released Mar 5, 2026
Audit
Dependencies
apache-airflowoptionalCommonly used for pipeline orchestration, enabled via `dbnd[airflow]` extra.
Agent activity
27 hits · last 30 days
node
22
OpenAI (training)
2
Amazon
1
Resources
dbnd — pip install dbnd · libregistry