---
id: stqdm
version: "0.2.1"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# stqdm — Easy progress bar for streamlit based on the awesome streamlit.progress and tqdm

License: permissive · Maintenance: active · Downloads: 255.0K/mo

## 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 above — 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

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

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

## Tags

streamlit progress bar, tqdm for streamlit, streamlit loop progress, iteration progress display, streamlit task progress, progress meter streamlit, tqdm streamlit integration, streamlit-ui, progress-tracking

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