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
- Set the version in
pyproject.tomland insrc/anyprogressbar/__init__.py, and turn the changelog's[Unreleased]section into## [<version>] - <date>. Commit and push. - Tag and push the tag:
git tag v<version> && git push origin v<version>. - 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 thepypienvironment, which onlyv*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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.