tqdm

4.67.3 · active · verified Sat Mar 28

tqdm is a Python library that provides fast, extensible progress bars for loops and iterables, making it easy to visualize the progress of your code. The current version is 4.67.3, released on February 3, 2026, with a release cadence of approximately every 89 days.

Warnings

breaking In version 4.67.2, support for 'pandas>=3' was added, which may affect compatibility with older pandas versions.
Fix: Ensure that your pandas version is updated to 3.0 or later to maintain compatibility.
gotcha Using 'tqdm' in asynchronous iterators without handling 'break' statements can prevent proper cleanup.
Fix: Use 'pbar.close()' manually or the context manager syntax to ensure proper cleanup.
gotcha When using 'tqdm' in Jupyter notebooks, the progress bar may not display correctly if not using the 'notebook' submodule.
Fix: Import 'tqdm' from 'tqdm.notebook' to ensure proper display in Jupyter notebooks.
gotcha Directly using 'print()' statements while a 'tqdm' progress bar is active can cause display issues.
Fix: Use 'tqdm.write()' instead of 'print()' to avoid conflicts with the progress bar display.

Install

pip install tqdm Install tqdm

Imports

tqdm
```
from tqdm import tqdm
```
Directly importing 'tqdm' without specifying the function can lead to errors when calling 'tqdm()'.
trange
```
from tqdm import trange
```
Using 'trange' directly simplifies the code and is more readable.

Quickstart

This example demonstrates how to use tqdm to add a progress bar to a loop that simulates work with a sleep function.

from tqdm import tqdm
import time

for i in tqdm(range(100)):
    time.sleep(0.1)  # Simulate work

view raw JSON →