Asterisk AI Voice Agent

Summary

Asterisk AI Voice Agent The most powerful, flexible open-source AI voice agent for Asterisk/FreePBX. Featuring a modular pipeline architecture that lets you mix and match STT, LLM, and TTS providers, plus 5 production-ready golden baselines validated for enterprise deployment. Quick Start • Features • Demo • Documentation • Community 📖 Table of Contents 🚀 Quick Start Get the Admin UI running in 2 minutes. For a complete first successful call walkthrough (dialplan + transport selection + verification), see: 1. Run Pre-flight Check (Required) # Clone repository git clone https://github.com/hkjarral/Asterisk-AI-Voice-Agent.git cd Asterisk-AI-Voice-Agent # Run preflight with auto-fix (creates .env, generates JWT_SECRET) sudo ./preflight.sh --apply-fixes Important: Preflight creates your .env file and generates a secure JWT_SECRET . Always run this first! 2. Start the Admin UI # Start the Admin UI container docker compose up -d --build admin-ui 3. Access the Dashboard Open in your browser: Local: http://localhost:3003 Remote server: http://<server-ip>:3003 Default Login: admin / admin Follow the Setup Wizard to configure your providers and make a test call. ⚠️ Security: The Admin UI is accessible on the network. Change the default password immediately and restrict port 3003 via firewall, VPN, or reverse proxy for production use. 4. Verify Installation # Start ai-engine (required for health checks) docker compose up -d --build ai-engine # Check ai-engine health curl http://localhost:15000/health # Expected: {"status":"healthy"} # View logs for any errors docker compose logs ai-engine | tail -20 5. Connect Asterisk The wizard will generate the necessary dialplan configuration for your Asterisk server. Transport selection is configuration-dependent (not strictly “pipelines vs full agents”). Use the validated matrix in: 🔧 Advanced Setup (CLI) For users who prefer the command line or need headless setup. Option A: Interactive CLI ./install.sh agent quickstart Option B: Manual...