.hvia-Avatar-Dateien ins richtige Verzeichnis legen, einige wenige Umgebungsvariablen in docker-compose.yaml konfigurieren und den Container starten. Sobald der Server läuft, kann sich dein LiveKit-Agent verbinden und in Echtzeit Avatare animieren.
Voraussetzungen
Stelle vor dem Start sicher, dass du Folgendes hast:
- Docker und Docker Compose installiert
- Eine NVIDIA-GPU mit CUDA 12, OpenGL-Unterstützung und mindestens 6 GB VRAM
- NVIDIA Container Toolkit installiert und konfiguriert
- Einen Avaluma-Lizenzschlüssel und mindestens eine
.hvia-Avatar-Datei
Schritte
1
Avatar-Dateien hinzufügen
Lege deine Der Container mountet dieses Verzeichnis unter
.hvia-Avatar-Dateien in das Verzeichnis assets/avatars/ innerhalb des Ordners avatar-server/:/app/assets/avatars, jede hier abgelegte Datei steht dem Server also beim nächsten Start sofort zur Verfügung.2
Umgebung konfigurieren
Öffne Setze
docker-compose.yaml und aktualisiere die Umgebungsvariablen unter dem Service avaluma-avatar-server:API_SERVER_HOST auf die öffentliche IP-Adresse oder den Domainnamen, über den Clients den Server erreichen. Wenn du den Server nur auf localhost ohne Reverse-Proxy betreibst, kannst du dies für lokale Tests so belassen.3
Server starten
Führe aus dem Verzeichnis Der Server startet im Hintergrund (detached) und ist unter
avatar-server/ aus:http://localhost:8080 erreichbar. Wenn du einen Reverse-Proxy verwendest oder den Server auf einer öffentlichen IP exponierst, stelle sicher, dass API_SERVER_HOST zu dieser Adresse passt.Um zu prüfen, ob der Container erfolgreich gestartet ist, sieh dir die Logs an:Vollständige docker-compose.yaml-Referenz
Hier die komplettedocker-compose.yaml zur Referenz:
Das Image ist mit
pull_policy: always konfiguriert, das heißt Docker zieht bei jedem Container-Neustart das neueste Image. Dein Avatar-Server bleibt so ohne manuellen Eingriff automatisch aktuell.