Skip to main content

anyprogressbar

Progress bars for Jupyter and marimo notebooks (an anywidget) and for terminals, from one model. The loop reports progress; what shows it is chosen by where the code runs.

Status: pre-alpha. The model, the notebook widget, a plain HTML bar for notebooks without it, the terminal bar and log lines exist. Seen working in JupyterLab and marimo; not yet tried in VS Code or Colab.

pip install "anyprogressbar[widget]"   # with the notebook widget (recommended)
pip install anyprogressbar             # no dependencies: scripts, CI, libraries
from anyprogressbar import progress

for row in progress(rows, "Loading", unit="rows"):
    ...

with progress(total=100, desc="Steps") as bar:   # by hand; a failure in the block shows
    bar.update(10)
    bar.set_postfix(loss=0.42)

for epoch in progress(range(3), "Epochs"):       # a bar inside a bar is its child
    for batch in progress(batches, "Batches"):
        ...

A bar ends as done, failed or stopped, and gives no time remaining until the estimate is worth showing. In a Jupyter or marimo notebook it is a widget whose clock ticks in the browser, so it keeps moving through one slow item and says when nothing has come for a while; when the work ends it becomes plain HTML, which stays in the saved notebook. Without the widget extra it is that HTML throughout, replaced in place. On a terminal the bar is redrawn in place; in a pipe, a file or a CI job it becomes a line every few seconds. ANYPROGRESSBAR=off silences every bar, log, terminal, notebook, widget and html force one. On a terminal, print and logging while bars are live go above them.

The widget needs anywidget in the environment that Jupyter itself runs in, not only in the kernel's: with uv, uv run --with jupyterlab --with anywidget jupyter lab. Where the page shows no widgets the bar is the plain HTML one, and says so once.

The documentation (tutorials, how-to guides, reference, explanation) is in docs/user, built into a site with uv run python scripts/build_docs.py.

Notebooks to run are in examples/: getting started, bars inside bars, how a bar ends, and stalls and where bars show.

The research behind the design is in docs/research/progress-bar-research.html, and the decisions in docs/decisions.

Development

(cd js && npm install && npm run build)   # the widget's bundle; npm test for its tests
uv sync
uv run nbstripout --install               # once per clone: commit notebooks without outputs
uv run python scripts/build_docs.py       # the documentation into site/ (examples run; warnings fail)
uv run python scripts/build_docs.py serve # the same, previewed at http://localhost:8000
uv run ruff check . && uv run ruff format --check . && uv run ty check && uv run pytest
(cd js && npx playwright install chromium firefox webkit)   # once: browsers for the next line
(cd js && npm run test:browser)           # the widget in three browsers, JupyterLab and marimo (build the docs first)

Releasing

  1. Set the version in pyproject.toml and in src/anyprogressbar/__init__.py, and turn the changelog's [Unreleased] section into ## [<version>] - <date>. Commit and push.
  2. Tag and push the tag: git tag v<version> && git push origin v<version>.
  3. The release workflow (.github/workflows/release.yml) checks that the tag, the version and the changelog agree, runs the tests, builds the sdist and the wheel, and installs the wheel in clean environments. It then waits for approval in the pypi environment, which only v* tags can use; once approved, it publishes to PyPI with trusted publishing and makes a GitHub release with the changelog's notes.

Metadata

Release files for anyprogressbar 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for anyprogressbar 0.1.0
File Size Uploaded Provenance Actions
anyprogressbar-0.1.0.tar.gz 86.2 kB With provenance Details for anyprogressbar-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for anyprogressbar 0.1.0
File Interpreter ABI Platform Actions
anyprogressbar-0.1.0-py3-none-any.whl Python 3 none any Details for anyprogressbar-0.1.0-py3-none-any.whl

Total release size: 122.5 kB

Release files / anyprogressbar-0.1.0.tar.gz

Download URL anyprogressbar-0.1.0.tar.gz
Size 86.2 kB
Tags Source
SHA-256 checksum
How to use checksums
ab8bd43d25b0833d91dc738bc5b45258caaac58229b0c6e2cc42751e83d77448
BLAKE2b-256 checksum
How to use checksums
f2ea53a29b45accbcdb20f21198eb3047e8709e056dc0f5b13910cca3fccf88b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / anyprogressbar-0.1.0-py3-none-any.whl

Download URL anyprogressbar-0.1.0-py3-none-any.whl
Size 36.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4533eefdb49042d4509c6f3b4c026d02cc2ad533e4b4621f74ef4a51996ac3e8
BLAKE2b-256 checksum
How to use checksums
ed3bbecea38942f47867c05c4643a049c03758ecbbe339e743904c9cd0e4b93a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for anyprogressbar 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for anyprogressbar-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page