How austecch/helix-ai-virtual-receptionist works
Helix is a self-hosted AI receptionist: Asterisk call events enter the Python agent, which handles caller audio, intent and policy, then responds, schedules, or routes to a person. The FastAPI API and web dashboard expose operational data and controls. The README documents major capabilities not visible in the sampled code, including after-hours handling, translation relay, voicemail, and CRM synchronization; these are represented at the agent boundary where their implementation details were not sampled. Dashboard-to-agent API wiring is documented, but individual page requests are not evidenced here.
Main entry points: ari_agent.py Call orchestrator · App.tsx Web dashboard · database.py Call and operations data · api.py REST API
Components 21
Call handling
- Call orchestrator
agent/ari_agent.py - REST API
agent/api.py
Voice intelligence
- Voice activity detection
agent/vad/silero_engine.py - Speech recognition
agent/stt/whisper_engine.py - Intent conversation
agent/llm/intent_engine.py - Translation engine
agent/llm/translate_engine.py - Speech synthesis
agent/tts/kokoro_engine.py
Operations and integrations
- Extension routing
agent/routing/router.py - Agent availability
agent/routing/agents.py - Call and operations data
agent/database.py - Calendar scheduling
agent/gcal/gcal.py - Vtiger CRM
agent/integrations/vtiger.py
Operations dashboard
- Web dashboard
dashboard/client/src/App.tsx - Operations pages
dashboard/client/src/pages - Dashboard API server
dashboard/server/routes.ts - Dashboard storage
dashboard/server/storage.ts
Other components
- Caller
- Asterisk PBX
- Business operator
- Google Calendar
- Vtiger service
Connections 24
- Caller → Asterisk PBX: calls
README.md - Asterisk PBX → Call orchestrator: sends call events
README.md - Call orchestrator → Voice activity detection: detects speech
agent/ari_agent.py - Call orchestrator → Speech recognition: transcribes audio
agent/ari_agent.py - Call orchestrator → Intent conversation: detects intent
agent/ari_agent.py - Call orchestrator → Translation engine: translates speech
agent/ari_agent.py - Call orchestrator → Speech synthesis: synthesizes replies
agent/ari_agent.py - Call orchestrator → Extension routing: looks up routes
agent/ari_agent.py - Call orchestrator → Agent availability: claims agents
agent/ari_agent.py - Call orchestrator → Calendar scheduling: books appointments
agent/ari_agent.py - Call orchestrator → Vtiger CRM: syncs caller records
agent/ari_agent.py - Call orchestrator → Call and operations data: records call data
agent/ari_agent.py - Extension routing → Call and operations data: reads routing rules
agent/routing/router.py - Agent availability → Call and operations data: reads agent state
agent/routing/agents.py - Calendar scheduling → Google Calendar: queries and books
README.md - Vtiger CRM → Vtiger service: uses CRM API
README.md - Call orchestrator → Asterisk PBX: controls call legs
README.md - REST API → Call and operations data: serves operations data
agent/api.py - Web dashboard → Operations pages: presents operations
- Business operator → Web dashboard: manages operations
README.md - Web dashboard → Dashboard API server: requests dashboard API
- Dashboard API server → Dashboard storage: reads and writes
dashboard/server/routes.ts - Web dashboard → REST API: uses REST API
README.md - Call orchestrator → REST API: runs alongside
agent/main.py