Skip to content

About

Drop-in replacements for Streamlit's default loading animation. Swap out the running man with one of 13 polished alternatives in seconds

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

st-custom-static

PyPI version Python versions License Build HF Space

Drop-in replacements for Streamlit's default loading animation. Swap out the running man with one of 13 polished alternatives in seconds.

Install

uv add st-custom-static
st-install --icon italic-h-sweep

Or with pip:

pip install st-custom-static
st-install --icon italic-h-sweep

Streamlit's version is auto-detected. Restart any running apps to apply the change.

Restore the original

st-install --restore

Available icons

Name Preview
italic-h-sweep italic-h-sweep
italic-h-striped italic-h-striped
italic-h-wave italic-h-wave
italic-h-scan italic-h-scan
italic-h-sequential italic-h-sequential
italic-h-cascade italic-h-cascade
three-dots Three Dots
bar-chart Bar Chart
progress-ring Progress Ring
spinning-sync Spinning Sync
pulsing-dot Pulsing Dot
rotating-gear Rotating Gear
hourglass Hourglass

Supported Streamlit versions

1.45.1, 1.46.1, 1.47.1, 1.48.1, 1.49.1, 1.50.0, 1.51.0, 1.52.0, 1.53.1, 1.54.0, 1.55.0, 1.56.0, 1.57.0

Pin a specific version if auto-detection is wrong:

st-install --icon italic-h-sweep --version 1.57.0

Use in a project

Add to pyproject.toml or requirements.txt:

st-custom-static

Then run st-install --icon <name> once after installing.

Manual build

Clone and build from source using the scripts in manual-build/.

How it works

Pre-built zips are published as GitHub Releases per version/icon combination. st-install downloads the matching zip, backs up Streamlit's original static/ folder, and replaces it with the custom build. The CI workflow in this repo rebuilds those zips automatically when icons or workflow config changes.

About

Drop-in replacements for Streamlit's default loading animation. Swap out the running man with one of 13 polished alternatives in seconds

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages