https://github.com/lperezmo/st-custom-static

Rebuilding streamlit repo with custom animation. Drop-in replacements to static folders (just find right version & copy on top of /site-packages/static/ folder)
https://github.com/lperezmo/st-custom-static

debian static streamlit uv

Last synced: about 2 months ago
JSON representation

Rebuilding streamlit repo with custom animation. Drop-in replacements to static folders (just find right version & copy on top of /site-packages/static/ folder)

• Host: GitHub
• URL: https://github.com/lperezmo/st-custom-static
• Owner: lperezmo
• License: gpl-3.0
• Created: 2025-11-30T01:06:04.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-11-30T01:29:23.000Z (7 months ago)
• Last Synced: 2025-12-02T06:30:14.720Z (7 months ago)
• Topics: debian, static, streamlit, uv
• Language: Shell
• Homepage:
• Size: 7.28 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# st-custom-static

[![PyPI version](https://img.shields.io/pypi/v/st-custom-static)](https://pypi.org/project/st-custom-static/)

[![Python versions](https://img.shields.io/pypi/pyversions/st-custom-static)](https://pypi.org/project/st-custom-static/)

[![License](https://img.shields.io/github/license/lperezmo/st-custom-static)](LICENSE)

[![Build](https://img.shields.io/github/actions/workflow/status/lperezmo/st-custom-static/build-release.yml?label=build)](https://github.com/lperezmo/st-custom-static/actions/workflows/build-release.yml)

[![HF Space](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Demo-blue)](https://huggingface.co/spaces/lperezmo/st-custom-static)

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

## Install

```bash

uv add st-custom-static

st-install --icon italic-h-sweep

```

Or with pip:

```bash

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

```bash

st-install --restore

```

## Available icons

| Name | Preview |

|------|---------|

| `italic-h-sweep` | ![italic-h-sweep](example_animations/italic-h-sweep.svg) |

| `italic-h-striped` | ![italic-h-striped](example_animations/italic-h-striped.svg) |

| `italic-h-wave` | ![italic-h-wave](example_animations/italic-h-wave.svg) |

| `italic-h-scan` | ![italic-h-scan](example_animations/italic-h-scan.svg) |

| `italic-h-sequential` | ![italic-h-sequential](example_animations/italic-h-sequential.svg) |

| `italic-h-cascade` | ![italic-h-cascade](example_animations/italic-h-cascade.svg) |

| `three-dots` | ![Three Dots](example_animations/three-dots.svg) |

| `bar-chart` | ![Bar Chart](example_animations/bar-chart.svg) |

| `progress-ring` | ![Progress Ring](example_animations/progress-ring.svg) |

| `spinning-sync` | ![Spinning Sync](example_animations/spin-sync.svg) |

| `pulsing-dot` | ![Pulsing Dot](example_animations/pulse-dot.svg) |

| `rotating-gear` | ![Rotating Gear](example_animations/rotate-gear.svg) |

| `hourglass` | ![Hourglass](example_animations/hourglass.svg) |

## 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:

```bash

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 ` once after installing.

## Manual build

Clone and build from source using the scripts in [`manual-build/`](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.