---
id: progress
version: "1.6.1"
license: ISC
license_treatment: permissive
maintenance: aging
---

# progress — Easy to use progress bars

License: permissive · Maintenance: aging · Downloads: 2.2M/mo

## What it is and what it does

progress is a lightweight Python library for rendering animated progress bars and spinners in the terminal. It offers seven distinct bar styles (Bar, ChargingBar, FillingSquaresBar, FillingCirclesBar, IncrementalBar, PixelBar, ShadyBar) and five spinner variants for tasks with unknown iteration counts. Bars track progress through a known maximum, displaying current position, percentage, elapsed time, and estimated time remaining; spinners animate indefinitely for operations where the endpoint is unknown.

The library is designed for minimal overhead and maximum simplicity: instantiate a bar or spinner, call next() in your loop, and call finish() when done. It supports context managers for cleaner code, iterator wrapping for common patterns, and extensive customization through template variables (index, max, remaining, percent, elapsed, eta, and more) and subclassing. With no runtime dependencies and support for Python 3.6 through 3.13, it integrates easily into existing projects.

Use it for:

- Display progress during file processing or data import pipelines where iteration count is known in advance.
- Show activity during long-running network requests or API calls using a spinner when completion time is uncertain.
- Wrap existing iterators to add progress reporting without restructuring loop logic using the iter() method.
- Create custom progress indicators by subclassing Bar or Spinner to match application branding or specific metrics.
- Monitor batch job execution in CLI tools, showing elapsed time and estimated completion time to users.

## Worth the install?

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

Provides terminal progress bars and spinners for displaying task completion status during long-running operations in Python scripts.

Yes. progress is a mature, dependency-free library with no known vulnerabilities, permissive licensing, and broad Python version support. Install it if you need terminal progress feedback in scripts or CLI tools. The aging maintenance status is not a blocker for a stable, feature-complete utility—the current version is production-ready.

## Install

pip install progress
uv add progress
poetry add progress

## Installing progress

Before you install: Low friction installation with no runtime dependencies. Maintenance status is aging—last release was 409 days ago—but the repository remains active with 1432 stars, suggesting stable, established use.

License in practice: Licensed under ISC (permissive), which allows commercial and private use with minimal restrictions, making it safe to include in most projects.

Quickstart:

pip install progress

from progress.bar import Bar

bar = Bar('Processing', max=20)
for i in range(20):
    bar.next()
bar.finish()

## Package facts

- License: ISC (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 2.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

progress bar terminal, python progress indicator, loading bar cli, task completion display, spinner animation python, console progress tracking, command line progress, cli-feedback, terminal-ui

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