stqdm

What it is and what it does

stqdm is a thin wrapper around tqdm that renders progress bars inside Streamlit apps instead of in the terminal. It inherits tqdm's API, so you can drop it into existing code with minimal changes — pass a range or iterable to stqdm() and get a Streamlit-native progress display. The package accepts tqdm parameters (desc, mininterval, etc.) and adds Streamlit-specific options like st_container to place the bar in the sidebar or main area, and frontend/backend flags to control where the bar appears.

The library is intentionally minimal and low-churn, designed to stay compatible with current Python versions (3.11+) and Streamlit updates. It supports pandas integration via stqdm.pandas(), scoped configuration through context managers, and global defaults via set_default_config(). With 293 GitHub stars and active maintenance, it's a stable choice for adding progress feedback to Streamlit workflows.

Use it for:

• Show iteration progress in a Streamlit app's main area or sidebar while processing a loop.
• Display progress during pandas DataFrame or Series operations (map, apply) in a Streamlit context.
• Temporarily override progress bar settings within a code block using scoped configuration.
• Suppress frontend display while keeping backend progress tracking for logging or debugging.
• Set app-wide default progress bar behavior (e.g., always show in sidebar) without per-loop configuration.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

stqdm wraps tqdm progress bars for Streamlit apps, displaying iteration progress in the Streamlit UI instead of or alongside terminal output.

Yes. stqdm solves a real gap in Streamlit apps—tqdm progress bars don't render in the UI by default. It has low install friction, no security vulnerabilities, permissive licensing, and active maintenance. Use it whenever you need to show loop or operation progress to users in a Streamlit interface.

Install

stqdm on PyPI

pip install stqdm

uv add stqdm

poetry add stqdm

Installing stqdm

Before you install

Low friction: pure Python wheel with only two runtime dependencies (streamlit and tqdm). Actively maintained for compatibility; CI tracks supported Python versions (3.11–3.14) and security reports are handled privately.

License in practice

Apache License 2.0 (permissive) — you can use, modify, and distribute stqdm freely in commercial and private projects with minimal restrictions.

Quickstart

pip install stqdm

from stqdm import stqdm
from time import sleep

for _ in stqdm(range(50)):
    sleep(0.5)

Requires Python 3.11 or later and a running Streamlit app context to display the progress bar in the UI.

Verify before relying

• Whether stqdm works correctly with all Streamlit container types beyond main and sidebar.
• Performance characteristics when iterating over very large ranges or with rapid updates.

Package facts

Evidence: stqdm-0.2.1-py3-none-any.whl

Keywords: bar, eta, meter, progress, progressbar, progressmeter, rate, streamlit, tqdm

Tags

More Python Modules packages