---
id: tqdm
version: "4.70.0"
license: MPL-2.0 AND MIT
license_treatment: copyleft
maintenance: active
---

# tqdm — Fast, Extensible Progress Meter

License: copyleft · Maintenance: active · Popularity: top 100 on PyPI

## Install

pip install tqdm
uv add tqdm
poetry add tqdm

## Description

|Logo|

tqdm
====

|Py-Versions| |Versions| |Conda-Forge-Status| |Docker| |Snapcraft|

|Build-Status| |Coverage-Status| |Branch-Coverage-Status| |Codacy-Grade| |Libraries-Rank| |PyPI-Downloads|

|LICENCE| |OpenHub-Status| |colab-demo| |binder-demo| |awesome-python|

``tqdm`` derives from the Arabic word *taqaddum* (تقدّم) which can mean "progress,"
and is an abbreviation for "I love you so much" in Spanish (*te quiero demasiado*).

Instantly make your loops show a smart progress meter - just wrap any
iterable with ``tqdm(iterable)``, and you're done!

.. code:: python

    from tqdm import tqdm
    for i in tqdm(range(10000)):
        ...

``76%|████████████████████████        | 7568/10000 [00:33<00:10, 229.00it/s]``

``trange(N)`` can also be used as a convenient shortcut for
``tqdm(range(N))``.

|Screenshot|
    |Video| |Slides| |Merch|

It can also be executed as a module with pipes:

.. code:: sh

    $ seq 9999999 | tqdm --bytes | wc -l
    75.2MB [00:00, 217MB/s]
    9999999

    $ tar -zcf - docs/ | tqdm --bytes --total `du -sb docs/ | cut -f1` \
        > backup.tgz
     32%|██████████▍                      | 8.89G/27.9G [00:42<01:31, 223MB/s]

Overhead is low -- about...

## AI interpretation — verify before relying

tqdm wraps any iterable to display a live progress bar with ETA and throughput metrics, with minimal overhead and only colorama as a runtime dependency.

Verdict: tqdm is a mature, widely-adopted progress-bar library with active maintenance, zero known vulnerabilities, and minimal install friction. The dual MPL-2.0/MIT license is permissive for end users. Recommended for any project needing loop progress visualization.

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