types-tqdm

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 on this page — 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

types-tqdm on PyPI

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

Evidence: types_tqdm-4.70.0.20260805-py3-none-any.whl

Tags

More Software Development packages