stqdm is the simplest way to handle a progress bar in streamlit app.
STqdm is intentionally small and low-churn, but it is actively maintained for compatibility and security.
The public API is kept close to tqdm, supported combinations are tracked in CI, and security reports should be sent privately through SECURITY.md.
pip install stqdmThis project uses uv for packaging and dependency management, with mise managing local tools and sourcing uv's .venv.
Trust the local mise config once, then install tools and dependencies:
mise trust
mise install
mise run install
mise run testmise manages local tools, uv manages the project environment and lockfile, and nox creates isolated compatibility environments. Nox is configured to use uv as its virtualenv backend when available.
Compatibility checks are managed with nox:
mise run nox-list
mise run compatYou can run the Streamlit demo app from demo/app/Home.py.
The live deployment is available at stqdm-demo.streamlit.app.
The demo surface and the behaviors it covers are documented in demo/FEATURES.md.
from time import sleep
from stqdm import stqdm
for _ in stqdm(range(50)):
sleep(0.5)from time import sleep
import streamlit as st
from stqdm import stqdm
for _ in stqdm(range(50), st_container=st.sidebar):
sleep(0.5)from time import sleep
from stqdm import stqdm
for _ in stqdm(range(50), desc="This is a slow task", mininterval=1):
sleep(0.5)STqdm inherits from tqdm, you can call stqdm.pandas() in a similar way. See tqdm docs.
from time import sleep
import pandas as pd
from stqdm import stqdm
stqdm.pandas()
pd.Series(range(50)).progress_map(lambda x: sleep(1))
pd.Dataframe({"a": range(50)}).progress_apply(lambda x: sleep(1), axis=1)from time import sleep
from stqdm import stqdm
# Default to frontend only
for i in stqdm(range(50), backend=False, frontend=True):
sleep(0.5)
for i in stqdm(range(50), backend=True, frontend=False):
sleep(0.5)stqdm can set default configuration for all future progress bars.
from time import sleep
from stqdm import stqdm
# Set default configuration to suppress frontend display
stqdm.set_default_config(frontend=False)
# Utilize stqdm with the default configuration
# It will use the new default configuration with frontend=False
for _ in stqdm(range(50)):
sleep(0.5)Use scope to temporarily override default arguments in a with block.
from time import sleep
import streamlit as st
from stqdm import stqdm
# Override default settings temporarily within a scope
with stqdm.scope(desc="Processing", bar_format="{desc}"):
for _ in stqdm(range(10)):
sleep(0.5)
# Outside the scope, stqdm reverts to the default settings
for _ in stqdm(range(10)):
sleep(0.5)
# Attach all the stqdm instances used inside the scope
# to the sidebar, then go back to normal
with stqdm.scope(st_container=st.sidebar):
function_1()
function_2()See the Streamlit demo app for the complete scoped configuration example.