---
id: tqdm-joblib
version: "0.0.5"
license: CC-BY-SA-4.0
license_treatment: unclear
maintenance: aging
---

# tqdm-joblib — Tracking progress of joblib.Parallel execution

License: unclear · Maintenance: aging · Downloads: 169.3K/mo

## What it is and what it does

tqdm_joblib wraps joblib.Parallel to display a live progress bar as parallel jobs execute. It originated as a StackOverflow snippet and packages that solution for reuse, offering two interfaces: a context manager (tqdm_joblib) and a decorator-style callable (ParallelPbar). The package depends only on tqdm for rendering and joblib for parallelization.

It solves a common workflow problem: when running many parallel tasks with joblib, you have no built-in way to see how many have completed. This package bridges that gap by hooking into joblib's callback system and feeding completion events to tqdm's progress bar. It is most useful in data processing, scientific computing, or batch job scenarios where visibility into long-running parallel work is valuable.

Use it for:

- Monitor progress of data preprocessing pipelines that use joblib.Parallel to process large datasets across multiple cores.
- Track completion of hyperparameter grid searches or other embarrassingly parallel scientific computations.
- Display real-time feedback in CLI tools that offload work to joblib without blocking the user's view of progress.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Adds a progress bar to joblib.Parallel execution using tqdm, displaying real-time completion status as parallel jobs run.

Yes, if you use joblib.Parallel and want simple progress visibility. Install friction is negligible and the dependency tree is minimal. However, the unclear license status (CC-BY-SA-4.0 is not a standard software license) and aging maintenance cycle (362 days since last release) warrant caution in commercial or mission-critical contexts. For research, prototyping, or internal tools, the trade-off is reasonable.

## Install

pip install tqdm-joblib
uv add tqdm-joblib
poetry add tqdm-joblib

## Installing tqdm-joblib

Before you install: Low friction install with a single runtime dependency (tqdm). Maintenance is aging—last release was 362 days ago—but the repository remains active and the package supports current Python versions (3.10+).

License in practice: Licensed under CC-BY-SA-4.0, which is not a standard software license and its applicability to code distribution is unclear. Legal review may be warranted before using in commercial or proprietary projects.

Quickstart:

pip install tqdm-joblib

from joblib import Parallel, delayed
from tqdm_joblib import tqdm_joblib

with tqdm_joblib(desc="Processing", total=10) as pbar:
    Parallel(n_jobs=4)(delayed(lambda x: x**2)(i) for i in range(10))

Requires Python 3.10 or later.

Verify before relying:

- Whether CC-BY-SA-4.0 is enforceable or recognized as a valid software license in your jurisdiction.
- Current maintenance status and whether the aging release cycle poses a risk for future Python version compatibility.

## Package facts

- License: CC-BY-SA-4.0 (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 169.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

joblib progress bar, parallel job progress tracking, tqdm joblib integration, monitor parallel execution, joblib task progress display, progress-tracking, parallel-computing

[View on SkillFed](https://skillfed.io/packages/tqdm-joblib) · [View on PyPI](https://pypi.org/project/tqdm-joblib/)