CLI-Tool
hkjarral/AVA-AI-Voice-Agent-for-Asterisk avatar
hkjarral/AVA-AI-Voice-Agent-for-Asterisk

AVA: ein KI-Sprachagent, der über AudioSocket und RTP mit Asterisk spricht

Ein Open-Source-KI-Sprachagent, der sich mithilfe der Audiosocket/RTP-Technologie in Asterisk/FreePBX integrieren lässt.

1.213 Sterne274 ForksPythonMIT

Auf einen Blick

Was ist das?
AVA verbindet Asterisk und FreePBX über eine modulare Pipeline mit Spracherkennungs-, LLM- und Sprachsynthese-Anbietern und bietet eine Admin-Oberfläche, agentenbasierte Weiterleitung und Tool-Aufrufe.
Für wen ist es gedacht?
Das README stellt AVA als einsatzorientiertes Projekt mit Admin-Oberfläche, goldenen Baseline-Konfigurationen und einem durch AI_AGENT gesteuerten Agentenmodell dar. Was sich allein aus dem Repository schwer verifizieren lässt, sind tatsächliches Produktionsverhalten, Sicherheitslage und Support-Zusagen.
Darf ich es kommerziell nutzen?
Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
Wird es noch gepflegt?
Ja. Die letzten Commits kamen vor 1 Tag.
In welcher Sprache ist es geschrieben?
Hauptsächlich Python, laut der Sprachstatistik von GitHub.

Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.

TIEFGEHENDE OPEN-SOURCE-ANALYSE

Ein quelloffener Sprachagent für Asterisk und FreePBX

AVA ist ein quelloffener KI-Sprachagent, der laut Repository-Beschreibung mit AudioSocket- und RTP-Technologie in Asterisk und FreePBX integriert. Das README beschreibt eine modulare Pipeline-Architektur, bei der Spracherkennungs-, LLM- und Sprachsynthese-Anbieter kombiniert werden können. Die Codebasis ist Python, und das README nennt Python 3.11+, Docker Compose und Asterisk 18+ als Anforderungen. Die Repository-Metadaten verweisen außerdem auf eine Live-Demo unter demo.agent6789.com, während das README separate US-Telefonnummern zum Testen der Sprachleitungen angibt.

Schnellstart und die Admin-Oberfläche

Der dokumentierte Weg zum ersten Anruf beginnt mit dem Klonen des Repositorys und dem Ausführen von `sudo ./preflight.sh --apply-fixes`, das laut README `.env` erstellt und ein JWT-Geheimnis generiert. Dann startet man die Admin-Oberfläche mit `docker compose -p asterisk-ai-voice-agent up -d --build --force-recreate admin_ui` und öffnet Port 3003. Beim ersten Start wird ein einmaliges Admin-Passwort in den Container-Logs ausgegeben. Das README weist Betreiber an, es beim ersten Login zu ändern und Port 3003 per Firewall, VPN oder Reverse-Proxy einzuschränken. Der Setup-Assistent konfiguriert Anbieter und erzeugt den Asterisk-Dialplan. Das README legt nicht fest, was passiert, wenn preflight übersprungen wird, oder wie der Assistent mit einem vorhandenen Dialplan umgeht.

Goldene Baselines und Anbieterwahl

Das README listet sieben goldene Baseline-Konfigurationen auf: OpenAI Realtime, Deepgram Voice Agent, Google Live, ElevenLabs Agent, Local Hybrid, Telnyx AI Inference und xAI Grok Voice Agent. Jede hat einen YAML-Konfigurationspfad wie `config/ai-agent.golden-openai.yaml`. Es dokumentiert außerdem weitere LLM-Anbieter, darunter MiniMax, einen vollständig lokalen Modus mit CPU-, GPU- und Split-Server-Topologien sowie eine Ollama-basierte Pipeline ohne API-Schlüssel. Das README behauptet Antwortzeiten unter zwei Sekunden für mehrere gehostete Baselines, aber das sind eigene Angaben des Projekts, keine unabhängigen Messungen. Die Repository-Metadaten enthalten keine Leistungstestdaten.

Agenten, Dialplan-Routing und Konfiguration

Seit v7.0.0, so das README, werden Agenten in der Admin-Oberfläche verwaltet und nicht in YAML-Context-Blöcken. Die Dialplan-Variable `AI_AGENT` wählt einen vom Betreiber verwalteten Agenten per Slug aus, wobei `AI_PROVIDER` als Übersteuerung pro Anruf verfügbar ist. Ein Beispiel-FreePBX-Snippet setzt `AI_AGENT=sales-agent` und ruft `Stasis(asterisk-ai-voice-agent)` auf. Die Konfiguration ist auf ein Drei-Dateien-Schema verteilt, das das README erwähnt, aber im bereitgestellten Abschnitt nicht auflistet; es verweist für Priorität und Beispiele auf die Dokumentation. Die Migration von altem `AI_CONTEXT` zu `AI_AGENT` wird als automatisch beim Upgrade beschrieben, wobei `AI_CONTEXT` ein veralteter Kompatibilitäts-Alias bleibt.

Tool-Aufrufe und Ressourcenzugriff pro Agent

Das README dokumentiert KI-gestützte Aktionen: Weiterleitung an Nebenstellen, Queues und Ringgruppen; Weiterleitung abbrechen; Auflegen mit Verabschiedung; Voicemail; E-Mail-Zusammenfassungen; und vom Anrufer angeforderte Transkripte. Zwei E-Mail-Tools sind standardmäßig deaktiviert. Seit v7.4 kann jeder Agent Weiterleitungsziele, Google Kalender, Microsoft Kalender und Voicemail-Postfächer erben, auswählen oder verweigern. Das README beschreibt auch HTTP-Tools vor, während und nach dem Anruf mit YAML-Beispielen. Es legt keine Ratenlimits, Wiederholungsrichtlinien oder die Authentifizierung der HTTP-Tools gegenüber beliebigen Endpunkten fest.

Versionsgeschichte und was das README offen lässt

Das Changelog im README deckt v7.5.4 bis v4.1 ab, wobei neuere Versionen sich auf datenschutzsichere Diagnose, Audio-Wiederherstellung, Breitband-AudioSocket und sicherere Upgrades konzentrieren. Das README behauptet Validierungsmatrizen und Community-Testbelege für einige lokale KI-Konfigurationen und verlinkt eine Validierungsmatrix für v7.5.4. Die Repository-Metadaten listen 29 offene Issues und 252 Forks auf, aber das belegt weder, dass diese Issues gelöst sind, noch dass das Projekt aktiv gepflegt wird. Die MIT-Lizenz gewährt Nutzung, Kopie, Änderung, Zusammenführung, Veröffentlichung, Verteilung, Unterlizenzierung und Verkauf und schließt Gewährleistung aus. Sie sagt nichts zu Support, Sicherheitsgarantien oder Produktionsreife; das muss separat geprüft werden.

Bei hkjarral/AVA-AI-Voice-Agent-for-Asterisk muss die praktische Einordnung an der veröffentlichten README bleiben. Der dokumentierte Stand nennt konkrete Dateien, Befehle oder Konfigurationswerte, die für einen Test wichtiger sind als allgemeine Produktversprechen. Diese Angaben beschreiben den vorgesehenen Weg, sie ersetzen keine Aussage über jede Plattform oder jede Betriebsumgebung. Für die Prüfung von AVA-AI-Voice-Agent-for-Asterisk sollte dieser Punkt mit einer kleinen, kontrollierten Eingabe nachvollzogen werden. Beobachten Sie die Ausgabe, Fehlermeldungen und erzeugten Dateien und halten Sie fest, welche Teile aus AVA-AI-Voice-Agent-for-Asterisk stammen und welche Abhängigkeiten von der lokalen Umgebung kommen.

Redaktionelles Fazit

Das README stellt AVA als einsatzorientiertes Projekt mit Admin-Oberfläche, goldenen Baseline-Konfigurationen und einem durch AI_AGENT gesteuerten Agentenmodell dar. Was sich allein aus dem Repository schwer verifizieren lässt, sind tatsächliches Produktionsverhalten, Sicherheitslage und Support-Zusagen.

Offizielle Quellen

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
Community-Notizen

Community-Notizen