Progress Table

Lightweight utility to display the progress of your process as a pretty table in the command line.

Alternative to TQDM whenever you want to track metrics produced by your process
Designed to monitor ML experiments, but works for any metrics-producing process
Allows you to see at a glance what's going on with your process
Increases readability and simplifies your command line logging
Is efficient: redraws only the modified rows

Change this:

example

Into this:

example

Examples

From examples/ directory:

Neural network training

example-training

Progress of multi-threaded downloads

example-download

Simulation and interactive display of Brownian motion

example-brown2d

Display of a game board

example-tictactoe

Quick start code

import random
import time

from progress_table import ProgressTable

# Create table object:
table = ProgressTable(num_decimal_places=1)

# You can (optionally) define the columns at the beginning
table.add_column("x", color="bold red")

for step in range(10):
    x = random.randint(0, 200)

    # You can add entries in a compact way
    table["x"] = x

    # Or you can use the update method
    table.update("x", value=x, weight=1.0)

    # Display the progress bar by wrapping an iterator or an integer
    for _ in table(10):  # -> Equivalent to `table(range(10))`
        # Set and get values from the table
        table["y"] = random.randint(0, 200)
        table["x-y"] = table["x"] - table["y"]
        table.update("average x-y", value=table["x-y"], weight=1.0, aggregate="mean")
        time.sleep(0.1)

    # Go to the next row when you're ready
    table.next_row()

# Close the table when it's finished
table.close()

Go to integrations page to see examples of integration with deep learning libraries.

Advanced usage

Go to advanced usage page for more information.

Troubleshooting

Excessive output

Progress Table works correctly in most consoles, but there are some exceptions:

Some cloud logging consoles (e.g. Kubernetes) do not handle live, carriage-return-based redraws properly. You can still use ProgressTable with interactive=0. This mode prints rows when they are finalized and does not display progress bars.
Some consoles, such as the PyCharm Python Console or IDLE, do not support moving the cursor to previous lines. You can still use ProgressTable with interactive=1. This mode can redraw the current line and display one progress-bar position, but previous rows remain visually frozen.

When interactive is omitted, it defaults to 1 in Jupyter, 0 when output is redirected, and 2 in an interactive terminal. Set it explicitly when creating the table, or override the automatic default with the PTABLE_INTERACTIVE environment variable, for example PTABLE_INTERACTIVE=1.

Installation

Install Progress Table easily with pip:

pip install progress-table

Alternatives

Progress bars: great for tracking progress, but they don't provide ways to display data in clear and compact way
- tqdm
- rich.progress
- keras.utils.Progbar
Libraries displaying data: great for presenting tabular data, but they lack the progress tracking aspect
- rich.table
- tabulate
- texttable

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

progress_table-3.3.0.tar.gz (29.2 kB view details)

Uploaded Jul 15, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

progress_table-3.3.0-py3-none-any.whl (21.7 kB view details)

Uploaded Jul 15, 2026 Python 3

File details

Details for the file progress_table-3.3.0.tar.gz.

File metadata

Download URL: progress_table-3.3.0.tar.gz
Upload date: Jul 15, 2026
Size: 29.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for progress_table-3.3.0.tar.gz
Algorithm	Hash digest
SHA256	`dd82da182bbe45feb372f2d653fd7bf52a3360d58324e724d53006a58c7a2845`
MD5	`794887da038ce1cc8f8aca8937aac363`
BLAKE2b-256	`06dd188f7fc959edbdf0243c85ca13f9d6a4dbdbde4ed19c49d8cbcf3deeb8ea`

See more details on using hashes here.

File details

Details for the file progress_table-3.3.0-py3-none-any.whl.

File metadata

Download URL: progress_table-3.3.0-py3-none-any.whl
Upload date: Jul 15, 2026
Size: 21.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for progress_table-3.3.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`fadd50ea384befae286d9e300a9674d586680e40cdcb1d60cae32987f09379af`
MD5	`5a8d12d5fba5408f32272ce01c485c94`
BLAKE2b-256	`0cac085bcd1357ee5952e8084391d80e71df17893823bc93228baa25a61a2944`