Spaces:

kinaar111
/

6-string-optimizer

Sleeping

App Files Files Community

6-string-optimizer / README.md

kinaar111

HF reliability: quick demo defaults, ETA, errors, reset

2b2215e verified about 1 month ago

preview code

Raw

History Blame Contribute Delete

2.83 kB

A newer version of the Gradio SDK is available: 6.22.0

Upgrade

metadata

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 — 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)

SPECTRUM → ▶ DEMO GUITAR (G3) — hear & see partials + per-string energy
OPTIMIZE → pick a preset → ▶ RUN OPTIMIZATION — S³ trajectory + VU meters
Theory tab (nav) — plain-language explanation of bursts, S³, Smith chart
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

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.

GitHub — 6-string-optimizer
physics_audio — Stiefel manifold string inverse problem
UI shell: mystery · signal style: qvpic

Deploy

HF_SPACE_ID=kinaar111/6-string-optimizer ./scripts/deploy_hf_space.sh