noamraph/tqdm

Add a progress meter to your loops in a second

Python

2,765

16 commits

updated Nov 30, 2023

See the code

README

Note: Please use the actively maintained version: https://github.com/tqdm/tqdm

tqdm

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

ScreenShot

tqdm (read taqadum, تقدّم) means "progress" in arabic.

You can also use trange(N) as a shortcut for tqdm(xrange(N))

Here's the doc:

def tqdm(iterable, desc='', total=None, leave=False, mininterval=0.5, miniters=1):
    """
    Get an iterable object, and return an iterator which acts exactly like the
    iterable, but prints a progress meter and updates it every time a value is
    requested.
    'desc' can contain a short string, describing the progress, that is added
    in the beginning of the line.
    'total' can give the number of expected iterations. If not given,
    len(iterable) is used if it is defined.
    If leave is False, tqdm deletes its traces from screen after it has finished
    iterating over all elements.
    If less than mininterval seconds or miniters iterations have passed since
    the last progress meter update, it is not updated again.
    """

def trange(*args, **kwargs):
    """A shortcut for writing tqdm(xrange)"""
    return tqdm(xrange(*args), **kwargs)

noamraph/tqdm

Add a progress meter to your loops in a second

Python

2,765

16 commits

updated Nov 30, 2023

See the code

README

Note: Please use the actively maintained version: https://github.com/tqdm/tqdm

tqdm

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

ScreenShot

tqdm (read taqadum, تقدّم) means "progress" in arabic.

You can also use trange(N) as a shortcut for tqdm(xrange(N))

Here's the doc:

def tqdm(iterable, desc='', total=None, leave=False, mininterval=0.5, miniters=1):
    """
    Get an iterable object, and return an iterator which acts exactly like the
    iterable, but prints a progress meter and updates it every time a value is
    requested.
    'desc' can contain a short string, describing the progress, that is added
    in the beginning of the line.
    'total' can give the number of expected iterations. If not given,
    len(iterable) is used if it is defined.
    If leave is False, tqdm deletes its traces from screen after it has finished
    iterating over all elements.
    If less than mininterval seconds or miniters iterations have passed since
    the last progress meter update, it is not updated again.
    """

def trange(*args, **kwargs):
    """A shortcut for writing tqdm(xrange)"""
    return tqdm(xrange(*args), **kwargs)

Project health

PyPI

Latest release

4.70.1 · Sep 11, 2026

Releases this year

11

Significant stargazers

(top 24 of 31)

M Bussonnier

1,437 followers · starred Mar 2014

Jannis Leidel

2,702 followers · starred Mar 2014

Sebastián Ramírez

32,342 followers · starred May 2018

Uwe L. Korn

650 followers · starred Jan 2014