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.