# 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.