Spaces:
Paused
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
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. | |