Spaces:
Paused
Download docs/WEBSITE.md from 2Btainment/absolution-omega: direct link, hf CLI and curl.
- Browser
- Download file 4.68 kB
-
https://huggingface.co/spaces/2Btainment/absolution-omega/resolve/main/docs/WEBSITE.md
- Command line
-
hf download hf://spaces/2Btainment/absolution-omega/docs/WEBSITE.md
-
curl -L -o WEBSITE.md https://huggingface.co/spaces/2Btainment/absolution-omega/resolve/main/docs/WEBSITE.md
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.batdoppelklicken. - macOS/Linux: Terminal im Projektordner öffnen und
bash start.shausführen. - Danach
http://127.0.0.1:8000im Browser öffnen. - Alternativ
docker compose up --buildund 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
- Im Studio auf „Datei auswählen“ klicken, Audio hineinziehen oder die vollständig synthetische Demo laden.
- Die Waveform und technische Werte kontrollieren. In der Waveform kannst du per Mausklick die Wiedergabeposition wählen.
- 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.
- Über Meine Stems jede Spur anhören und als WAV 32-bit Float herunterladen oder alle zusammen als ZIP exportieren.
- 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.