---
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
```