Spaces:
Sleeping
Sleeping
File size: 2,829 Bytes
8c20398 9146d63 8c20398 9146d63 8c20398 9146d63 5c7853d 8c20398 9146d63 5c7853d 9146d63 5c7853d 9146d63 5c7853d 9146d63 5c7853d 9146d63 5c7853d 9146d63 5c7853d 9146d63 0980d2c d46bde8 9146d63 d46bde8 5c7853d d46bde8 9146d63 2b2215e 5c7853d d46bde8 9146d63 d46bde8 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | ---
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
``` |