How to Install `tqdm` in Python

v4.67.3 CLI & Utilities Python >=3.7 MPL-2.0 AND MIT

Fast, Extensible Progress Meter

Install pip install tqdm

What is tqdm?

Fast, Extensible Progress Meter

`` 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 ``, and you're done!

PyPI page →

Quick Start

Minimal example to get started with tqdm:

from tqdm import tqdm
import time

for i in tqdm(range(100), desc="Processing"):
    time.sleep(0.01)

# With a list comprehension
items = list(range(1000))
results = [x ** 2 for x in tqdm(items)]

Installation

pip (standard)

pip install tqdm

Virtual environment (recommended)

python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate
pip install tqdm

pip3

pip3 install tqdm

conda

conda install -c conda-forge tqdm

Poetry

poetry add tqdm

Dependencies

Installing tqdm will also install these packages:

colorama importlib_metadata

Verify the Installation

After installing, confirm the package is available:

python -c "import tqdm; print(tqdm.__version__)"

If this prints a version number, installation succeeded. If you see a ModuleNotFoundError, see the errors section below.

Installation Errors

Common errors when installing tqdm with pip.

ModuleNotFoundError: No module named 'tqdm'

Cause: The package is not installed in the current Python environment.

Fix: Run pip install tqdm. If using a virtual environment, ensure it is activated first.

ModuleNotFoundError: No module named 'tqdm' (installed but still failing)

Cause: pip installed the package into a different Python than the one running your script.

Fix: Use python -m pip install tqdm to install into the interpreter you are running.

ImportError: cannot import name 'X' from 'tqdm'

Cause: The function or class does not exist in the installed version.

Fix: Check the version with pip show tqdm and upgrade with pip install --upgrade tqdm.

pip: command not found

Cause: pip is not in PATH or Python was not added to PATH during installation.

Fix: Try python -m pip install tqdm. On macOS/Linux try pip3.

PermissionError: [Errno 13] Permission denied

Cause: No write access to the system Python package directory.

Fix: Use a virtual environment, or add --user: pip install --user tqdm

SSL: CERTIFICATE_VERIFY_FAILED

Cause: pip cannot verify PyPI's SSL certificate — common behind corporate proxies.

Fix: Try: pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org tqdm

Recent Releases

Version	Released
`4.67.3` latest	2026-02-03
`4.67.2`	2026-01-30
`4.67.1`	2024-11-24
`4.67.0`	2024-11-06
`4.66.6`	2024-10-28

Full release history on PyPI →

Manage tqdm

Upgrade to latest version

pip install --upgrade tqdm

Install a specific version

pip install tqdm==4.67.3

Uninstall

pip uninstall tqdm

Check what is installed

pip show tqdm

Last updated: 2026-04-11 • Data from PyPI

How to Install tqdm in Python