alive-progress

A new kind of Progress Bar, with real-time throughput, ETA, and very cool animations!

What is alive-progress?

A new kind of Progress Bar, with real-time throughput, ETA, and very cool animations!

Overview of alive-progress

What it is

A new kind of Progress Bar for Python, with real-time throughput, ETA, and animations. It is designed to show that a lengthy task is in progress and has not crashed, and to provide accurate time-to-completion estimates. It includes a live spinner that reacts to processing speed, automatic print and logging hooks, and a final receipt with total items, elapsed time, and observed throughput. It also supports suspending and resuming processing, and detecting under and overflows.

Key features

  • A live spinner that dynamically gets faster or slower with actual processing speed.
  • Multithreaded bar that updates at a fraction of the actual processing speed to keep CPU usage low.
  • Accurate ETA using an intelligent Exponential Smoothing Algorithm.
  • Automatic print and logging hooks that enrich outputs with the current bar position.
  • Final receipt including total items, elapsed time, and observed throughput.
  • Detects under and overflows, enabling tracking of hits, misses, or any desired counts.
  • Suspend and resume processing, returning to the Python prompt and then seamlessly resuming.
  • Highly customizable with ready-to-use spinner and bar styles, and factories to create custom animations.

Use cases

  • Monitoring lengthy processing tasks in Python scripts.
  • Providing visual feedback for batch processing, data pipelines, or file operations.
  • Debugging or inspecting progress in SSH sessions where connection freeze might be a concern.
  • Suspending processing to manually fix items and then resuming.
  • Tracking counts that are not necessarily the performed iterations (e.g., hits, misses).

Getting started

bash pip install alive-progress Then in Python: python from alive_progress import alive_bar with alive_bar(100) as bar: for i in range(100): # process item bar()

License and pricing

MIT license. Open source. No pricing information stated.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/rsalmeialive-progress.svg)](https://yunodb.com/tools/rsalmeialive-progress?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/rsalmeialive-progress?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/rsalmeialive-progress.svg" alt="Featured on YunoDB" height="20"></a>