tqdm/tqdm repository overview

⁠tqdm

tqdm means "progress" in Arabic (taqadum, تقدّم) and is an abbreviation for "I love you so much" in Spanish (te quiero demasiado).

Instantly make your loops show a smart progress meter and stats - just replace any pipe "|" with "| tqdm |", and you're done!

seq 7654321 | docker run -i --rm tqdm/tqdm --bytes | wc -l
57.3MB [00:17, 3.53MB/s]
7654321
$ 7z a -bd -r backup.7z docs/ | grep Compressing | \
   docker run -i --rm tqdm/tqdm --total $(find docs/ -type f | wc -l) --unit files >> backup.log
100%|███████████████████████████████▉| 8014/8014 [01:37<00:00, 82.29files/s]

The docker image also ships with an interactive Python terminal:

docker run --rm -it --entrypoint python tqdm/tqdm

Overhead is low -- about 60ns per iteration.

In addition to its low overhead, tqdm uses smart algorithms to predict the remaining time and to skip unnecessary iteration displays, which allows for a negligible overhead in most cases.

tqdm works on any platform (Linux, Windows, Mac, FreeBSD, NetBSD, Solaris/SunOS), in any console or in a GUI, and is also friendly with IPython/Jupyter notebooks.

tqdm does not require any dependencies, just an environment supporting carriage return \r and line feed \n control characters.