Skip to main content

​
What is Arkenos?

Arkenos is an open-source orchestration layer for enterprise-grade conversational AI. Build, deploy, and manage production voice agents — configure them from the dashboard or write custom Python agents with a built-in coding assistant. Connect your own STT, LLM, and TTS providers, handle inbound/outbound phone calls with auto-provisioned SIP infrastructure, and get real-time transcription, cost tracking, and post-call intelligence out of the box.

​
Key Features

Agent Configuration

Create voice agents with custom system prompts, STT providers, voice selection, function calling, and webhooks — all from the dashboard.

Custom Agents

Write custom Python agents with full code control. Built-in coding assistant helps you write, edit, and deploy agent code from the browser.

Voice Pipeline

Real-time STT → LLM → TTS pipeline powered by LiveKit with sub-second latency and Silero VAD for natural turn-taking.

Telephony

Inbound and outbound phone calls via Twilio SIP trunks. Buy, assign, and manage numbers — SIP infrastructure is auto-provisioned.

Call Intelligence

AI-generated summaries, sentiment analysis, topic extraction, and action items after every call.

Cost Tracking

Per-session cost breakdown across STT, LLM, and TTS. Aggregation by provider, agent, and time period.

Dashboard-Managed Keys

All provider API keys configured via the dashboard and encrypted with AES-256-GCM. No .env files for provider credentials.

Full Dashboard

Web dashboard with analytics, call logs, live transcripts, agent management, phone number provisioning, and API key settings.

​
Tech Stack

ComponentTechnology
FrontendNext.js 16, React 19, Tailwind CSS, shadcn/ui
AuthBetter Auth
BackendFastAPI, SQLAlchemy, PostgreSQL
AgentPython, LiveKit Agents SDK
STTAssemblyAI, ElevenLabs, Deepgram
LLMGoogle Gemini
TTSResemble AI
TelephonyTwilio (auto-provisioned SIP)
Real-timeLiveKit

​
Architecture

Arkenos/
├── frontend/       # Next.js 16 dashboard (Better Auth)
├── backend/        # FastAPI REST API + encrypted key store
├── agent/          # Python voice agent (LiveKit Agents SDK)
└── docker-compose.yml  # 5 services: frontend, backend, agent, postgres, minio
Five services run together:
ServiceDescriptionURL
FrontendNext.js dashboard with Better Authhttp://localhost:4200
BackendFastAPI API server + encrypted key storehttp://localhost:4201
AgentLiveKit voice agent workerConnected to LiveKit Cloud
PostgreSQLDatabase (agents, sessions, keys, costs)localhost:5434
MinIOObject storage for custom agent fileshttp://localhost:9002
The agent requires no .env file — it fetches all API keys from the backend dashboard on startup. Auth is handled by Better Auth using your Postgres database directly — no external auth keys needed.

​
Next Steps

Cloud Deploy

Deploy to Railway with one click — zero config required.

Quick Start

Get Arkenos running with Docker Compose in under 5 minutes.

Local Development

Set up each service individually for development with hot-reload.

API Reference

Explore all REST API endpoints with an interactive playground.

Architecture

Understand the voice pipeline, database schema, and system design.