absolution-omega / docs /WEBSITE.md
2Btainment's picture
Initial HF Docker Space deploy
29c3be9 verified
|
Raw History Blame Contribute Delete
4.68 kB
# ABSOLUTION Ω · Website v0.2.1
## Der direkte Weg ins Studio
Das Projekt enthält eine lokal laufende Website mit einer echten Python-Audio-Engine.
Die Website **ist kein reines Design oder Mock-up**. Der Ablauf
Dateiimport → HPSS-Audioverarbeitung → WAV-Stems → Forensikbericht → ZIP-Export
ist direkt an das FastAPI-Backend angeschlossen.
- Windows: `start_windows.bat` doppelklicken.
- macOS/Linux: Terminal im Projektordner öffnen und `bash start.sh` ausführen.
- Danach `http://127.0.0.1:8000` im Browser öffnen.
- Alternativ `docker compose up --build` und dann dieselbe Adresse öffnen.
Beide Startskripte installieren fehlende Python-Pakete mit `pip`. Dieser
Installationsschritt kann Pakete aus dem Internet beziehen. Die eigentliche
Audioanwendung verarbeitet Dateien lokal und lädt keine KI-Gewichte nach.
## Keine Drei-Minuten-Beschränkung mehr
Es gibt **keine feste Laufzeitbegrenzung für Audiodateien**. Lange Dateien
werden für den HPSS-Modus blockweise analysiert und separiert, sodass nicht
die gesamte Audiodatei auf einmal in den Arbeitsspeicher geladen werden muss.
Die maximale Dateigröße beträgt standardmäßig **1024 MiB** (1 GiB);
dieses Größenlimit ist ein Schutz für die lokale Festplatte, kein Zeitlimit.
Bei Bedarf vor dem Serverstart `ABSOLUTION_MAX_UPLOAD_MIB` setzen
(z. B. `2048` für 2 GiB; maximal 4096 MiB in dieser Version). Für große
Dateien benötigst du entsprechend mehr freien Speicherplatz für Original,
Vorschaudateien, separate Stems und ZIP-Export.
Die Demucs-KI-Erweiterung verfügt noch nicht über einen speicherschonenden
Streaming-Import und kann für sehr lange Aufnahmen zu viel RAM/VRAM benötigen.
## Bedienung in fünf Schritten
1. Im **Studio** auf „Datei auswählen“ klicken, Audio hineinziehen oder
die vollständig synthetische Demo laden.
2. Die Waveform und technische Werte kontrollieren. In der Waveform
kannst du per Mausklick die Wiedergabeposition wählen.
3. **Harmonisch / Perkussiv** wählen und „Separation starten“ drücken.
Demucs ist nur wählbar, wenn die lokalen Checkpoints konfiguriert sind;
das ist kein Nachweis, dass die Inferenz in deiner Umgebung funktioniert.
4. Über **Meine Stems** jede Spur anhören und als WAV 32-bit Float
herunterladen oder alle zusammen als ZIP exportieren.
5. Den **Forensik-Bericht** öffnen: SHA-256 des Originals, Klangdiagnostik,
Verarbeitungsverfahren und Rekonstruktionsfehler.
## Website-Bereiche
- Studio: Dateiimport, Demo, Waveform, Kennzahlen, Modellauswahl, Jobstatus.
- Meine Stems: Vorschau, Einzel-WAV und ZIP-Export.
- Forensik-Bericht: numerische Konsistenzprüfung und Quellennachweis.
- Hilfe & Technik: Anleitung, reale Funktionen und klare Einschränkungen.
- Player: globale Wiedergabe mit Play/Pause, ±10 Sekunden, Seek und Lautstärke.
Die Oberfläche ist vollständig in HTML/CSS/Vanilla JavaScript umgesetzt,
benötigt weder Node.js noch CDN-Dienste und ist für Desktop und Mobilgeräte
responsiv. Das letzte Projekt wird über seine lokale Projekt-ID im Browser
wiedererkannt. Projektdateien werden auf dem lokalen Server gespeichert.
## Grenzen und sichere Nutzung
**Nicht öffentlich hosten:** Das Backend hat noch keine Authentifizierung,
keine Multiuser-Trennung und keine produktionsreife Absicherung.
Binde Uvicorn ausschließlich an `127.0.0.1` bzw. nutze eine isolierte,
geschützte Entwicklungsumgebung. Der Docker-Port ist bereits auf Loopback
begrenzt. **Nicht direkt zu `0.0.0.0` oder ins offene Internet veröffentlichen.**
Die eigenständige Website wird als Projektdatei ausgeliefert; ein
@sites-Publishing-Workflow oder eine öffentlich erreichbare URL wurde nicht
ausgeführt. Für eine öffentliche Bereitstellung braucht es zuerst
Authentifizierung, Quotas, Viren-/Payload-Prüfung, sichere Worker-Isolation,
Rate Limits und HTTPS.
HPSS ist deterministische DSP, keine semantische oder neuronale
Instrumenten-/Stimmtrennung. Demucs ist als optionaler Adapter integriert,
erfordert jedoch lokal bereitgestellte kompatible Gewichte und Pakete.
## Tests
```
python -m pip install -e ".[dev]"
python -m pytest -q
node --check app/static/app.js
```
Die automatisierten Regressionstests umfassen jetzt eine vollständige\n181-Sekunden-Aufnahme sowie eine mehrteilige Stereoaufnahme an Chunk-Grenzen.\n\nBrowser-Interaktionen wurden zusätzlich mit isolierten, nachgebildeten
API-Antworten überprüft: Demo-Import, Jobstart, drei Stems, Berichtsansicht,
Navigation und mobile Menübedienung. Das ist **kein vollständiger E2E-Test
gegen einen Browser mit echtem lokalem HTTP-Zugriff**. Die FastAPI-Tests
überprüfen den echten Backend-Datenpfad gesondert.