Zum Hauptinhalt springen
Avaluma AI nutzt Umgebungsvariablen, um Zugangsdaten und Service-Endpunkte für Avatar-Server und LiveKit-Agent zu konfigurieren. Setze diese Variablen, bevor du einen der Dienste startest — falsch konfigurierte oder fehlende Werte sind die häufigste Ursache für Startfehler.

​
LiveKit-Agent-Variablen

Der LiveKit-Agent liest seine Konfiguration beim Start aus .env.local. Alle als Erforderlich markierten Variablen müssen vorhanden sein, sonst beendet sich der Agent mit einem Fehler.
VariableErforderlichStandardBeschreibung
AVALUMA_LICENSE_KEYJa—Dein Avaluma-Lizenzschlüssel von avaluma.ai.
AVATAR_SERVER_URLJahttps://api.avaluma.aiURL des laufenden Avatar-Servers. Bei Self-Hosting durch die URL deines eigenen Servers ersetzen.
LIVEKIT_URLJa—WebSocket-URL deines LiveKit-Servers (z. B. wss://your-project.livekit.cloud).
LIVEKIT_API_KEYJa—API-Key für dein LiveKit-Projekt.
LIVEKIT_API_SECRETJa—API-Secret für dein LiveKit-Projekt.
AGENT_NAMENeinagent-1Eindeutiger Name für diesen Agent-Worker. Setze einen unterschiedlichen Wert je Agent, wenn du mehrere Agenten im selben LiveKit-Projekt betreibst.

​
Avatar-Server-Variablen

Der Avatar-Server liest seine Konfiguration aus dem environment-Block in docker-compose.yaml. Setze diese Werte, bevor du docker compose up ausführst.
VariableErforderlichStandardBeschreibung
API_UTILS_PWDJa—Passwort für die Utility-API des Avatar-Servers. Wähle einen starken, eindeutigen Wert und halte ihn geheim.
API_SERVER_HOSTNein—Öffentliche IP-Adresse oder Domainname des Servers. Der Avatar-Server nutzt diesen Wert, um seine eigene Adresse an verbundene Agenten zu melden. Erforderlich bei Verwendung eines Reverse-Proxys oder beim Exponieren auf einer öffentlichen URL.

​
Variablen setzen

​
LiveKit-Agent — .env.local

Kopiere .env.example nach .env.local und trage deine Zugangsdaten ein: 
cp .env.example .env.local
Bearbeite anschließend .env.local mit deinen echten Werten:
.env.local
AVALUMA_LICENSE_KEY="your-license-key"
AVATAR_SERVER_URL="https://your-avatar-server.com"  # oder https://api.avaluma.ai

LIVEKIT_URL="wss://your-project.livekit.cloud"
LIVEKIT_API_KEY="your-api-key"
LIVEKIT_API_SECRET="your-api-secret"
Der Agent lädt gezielt .env.local über load_dotenv(".env.local"). Eine Datei namens .env wird nicht automatisch berücksichtigt — verwende den richtigen Dateinamen.

​
Avatar-Server — docker-compose.yaml

Setze die Avatar-Server-Variablen direkt im environment-Block von docker-compose.yaml:
docker-compose.yaml
environment:
  - API_SERVER_HOST=api.yourdomain.com
  - API_UTILS_PWD=CHANGE_THIS
Ersetze api.yourdomain.com durch die tatsächliche öffentliche Domain oder IP deines Servers und CHANGE_THIS durch ein starkes Passwort, bevor du den Server startest.
Committe niemals .env.local und gib AVALUMA_LICENSE_KEY, LIVEKIT_API_SECRET oder API_UTILS_PWD nicht in Versionskontrolle oder öffentlichen Repositories preis. Füge .env.local direkt nach dem Anlegen zu deiner .gitignore hinzu.