Spaces:
Sleeping
Sleeping
| title: 6-String Optimizer | |
| emoji: 🎸 | |
| colorFrom: yellow | |
| colorTo: red | |
| sdk: gradio | |
| sdk_version: 5.12.0 | |
| python_version: 3.12 | |
| app_file: app.py | |
| pinned: false | |
| license: mit | |
| short_description: Riemannian S³ burst optimizer + guitar audio showcase | |
| tags: | |
| - optimization | |
| - riemannian | |
| - audio-analysis | |
| - guitar-physics | |
| - research | |
| - gradio | |
| - geoopt | |
| # 6-String Optimizer — Signal Analyzer | |
| **What is this?** An artistic **research showcase** for [GeooptBurstOptimizer](https://github.com/kinaar8340/6-string-optimizer) — a Riemannian optimizer on the **3-sphere (S³)** that escapes plateaus via **punctuated-equilibrium bursts**, using a six-string guitar metaphor and real audio analysis. | |
| > Not a guitar tension/gauge calculator — a demo that makes abstract manifold optimization *visible* and *audible*. | |
| ## Try it (60 seconds) | |
| 1. **SPECTRUM** → ▶ DEMO GUITAR (G3) — hear & see partials + per-string energy | |
| 2. **OPTIMIZE** → pick a preset → ▶ RUN OPTIMIZATION — S³ trajectory + VU meters | |
| 3. **Theory** tab (nav) — plain-language explanation of bursts, S³, Smith chart | |
| 4. Keypad **11** — guided tour (skippable) | |
| ## Features | |
| | Tab | What you get | | |
| |-----|----------------| | |
| | **OPTIMIZE** | Live S³ trajectory, loss, twist, six-string VU (High E → Low E) | | |
| | **SPECTRUM** | Waveform, STFT, partial tracks, harmonic energy per string | | |
| | **STRINGS** | Hierarchy table + live VU mirror during optimization | | |
| | **PHYSICS** | Smith chart Γ preview + reconstruction pyramid overview | | |
| | **Terminal** | Retro-futuristic keypad, phosphor scan, streaming readouts | | |
| **Presets:** Standard Burst · Fisher-Rao Enhanced · Aggressive Plateau Escape | |
| **New:** RiemannianAdam side-by-side · modal synthesis before/after · tension calculator · plot PNG export · KaTeX theory · mobile CSS | |
| ## Local run | |
| ```bash | |
| cd hf_staging | |
| python -m venv .venv && source .venv/bin/activate | |
| pip install -r requirements.txt | |
| python app.py | |
| ``` | |
| ## Known limitations (HF free tier) | |
| - Runs on **cpu-basic** — default **Quick Demo** is 2500 steps (~20s). Full 12k-step research runs may timeout; clone locally for those. | |
| - Cold starts after sleep can take 30–60s. | |
| - **Compare vs RiemannianAdam** is capped at 3000 steps on HF and roughly doubles runtime. | |
| - Best on desktop Chrome/Firefox; allow optimization to finish before switching tabs. | |
| ## Related | |
| - [GitHub — 6-string-optimizer](https://github.com/kinaar8340/6-string-optimizer) | |
| - [physics_audio](https://github.com/kinaar8340/6-string-optimizer/tree/main/physics_audio) — Stiefel manifold string inverse problem | |
| - UI shell: [mystery](https://huggingface.co/spaces/kinaar111/mystery) · signal style: [qvpic](https://huggingface.co/spaces/kinaar111/qvpic) | |
| ## Deploy | |
| ```bash | |
| HF_SPACE_ID=kinaar111/6-string-optimizer ./scripts/deploy_hf_space.sh | |
| ``` |