---
id: types-tqdm
version: "4.70.0.20260805"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-tqdm — Typing stubs for tqdm

License: permissive · Maintenance: active · Downloads: 6.2M/mo

## What it is and what it does

types-tqdm is a type stub package that provides type annotations for the tqdm progress bar library. It is part of the typeshed project and allows static type checkers like mypy, pyright, and ty to understand and validate code that uses tqdm. The stubs are kept in sync with tqdm 4.70.* and are tested against multiple type checkers to ensure accuracy.

This package has no runtime dependencies and does not change how tqdm behaves—it only adds type information for development-time type checking. If you use tqdm in a codebase where you run mypy or similar tools, installing this package lets those tools understand tqdm's API and catch type errors.

Use it for:

- Enable mypy or pyright to type-check code that imports and uses tqdm progress bars.
- Catch type errors in scripts that pass incorrect arguments to tqdm functions.
- Provide IDE autocomplete and type hints for tqdm API calls in editors that support type stubs.
- Maintain strict type checking in a project that depends on tqdm without suppressing type warnings.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type annotations for the tqdm progress bar library, enabling type checkers like mypy and pyright to validate code that uses tqdm.

Yes, if you use tqdm and run a type checker (mypy, pyright, or similar) on your code. It is a lightweight, actively maintained stub package with no runtime cost. If you do not use type checking, it provides no value.

## Install

pip install types-tqdm
uv add types-tqdm
poetry add types-tqdm

## Installing types-tqdm

Before you install: Very low friction—a pure stub package with no runtime dependencies, distributed as a wheel. Actively maintained as part of typeshed, with a release 9 days old.

License in practice: Apache-2.0 permissive license allows free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install types-tqdm

# Then in your code, type checkers will understand tqdm imports:
from tqdm import tqdm
for item in tqdm(iterable):
    pass

Requires Python >= 3.10. Type checking is a development-time tool; this package does not affect runtime behavior.

Verify before relying:

- Whether this stub package is automatically discovered by type checkers or requires explicit configuration.
- Compatibility with type checkers other than mypy 2.3.0, pyright 1.1.411, and ty 0.0.59.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 6.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tqdm type stubs, type hints for tqdm, tqdm type checking, typeshed stubs, progress bar type annotations, mypy tqdm support, pyright tqdm types, type-stubs, type-checking

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