Deploy a custom AI voice receptionist for ANY business in 5 minutes — no database setup required.

AgentDesk is an open-source, white-label voice agent platform. Pick a template, answer 5 questions, and have a live AI phone agent handling real calls.

python -m cli.init

# 1. Clone the repo
git clone https://github.com/princepal9120/agentdesk
cd agentdesk

# 2. Run the setup wizard (no dependencies needed!)
python -m cli.init

# 3. Start the backend
cd backend && uvicorn app.main:app --reload

# 4. Start the frontend
cd frontend && npm install && npm run dev

git clone https://github.com/princepal9120/agentdesk
cd agentdesk

# Copy and fill in ONLY your OpenAI key
cp backend/.env.example backend/.env
# Edit backend/.env and add: OPENAI_API_KEY=sk-...

docker compose up

Open http://localhost:3000 → dashboard ready.

The setup wizard lets you pick a niche preset. Each template includes a battle-tested system prompt, tool definitions, and FAQ data.

agentdesk/
├── cli/               # Setup wizard (python -m cli.init)
├── backend/           # FastAPI + SQLAlchemy + SQLite/Postgres
│   ├── app/
│   │   ├── api/       # REST endpoints
│   │   ├── core/      # DB, config, rate limiting
│   │   └── models/    # Agency, Business, Call, Booking
│   ├── templates/     # Niche preset JSON files
│   └── agent/         # LiveKit voice agent runtime
└── frontend/          # Next.js dashboard

Default stack (local dev):

• Database: SQLite (zero install — file at agentdesk.db)
• Rate limiting: In-memory (no Redis needed)
• Voice: OpenAI Realtime API

Production stack:

• Database: PostgreSQL (DATABASE_URL=postgresql+asyncpg://...)
• Rate limiting: Redis (REDIS_URL=redis://...)
• Voice: LiveKit + Deepgram + Cartesia

Only one variable required for local demo:

OPENAI_API_KEY=sk-...

For real phone calls, add:

TWILIO_ACCOUNT_SID=AC...
TWILIO_AUTH_TOKEN=...
TWILIO_PHONE_NUMBER=+1...

1. agentdesk init — wizard asks your business type, name, website URL, and API keys
2. Scrapes your website to build an instant knowledge base
3. Generates a custom system prompt from your template
4. Auto-configures Twilio webhooks via Cloudflare tunnel
5. Saves everything to local SQLite — no external DB needed

• Visual conversation flow builder (drag-drop)
• Local LLM support (Ollama + Whisper + Kokoro)
• PDF/document knowledge base upload
• Multi-language voice support
• One-click Railway/Render deploy button

Please read CONTRIBUTING.md for details on local environment setup, style guidelines, and our pull request process.

1. Fork the repo
2. Create a feature branch: git checkout -b feat/my-feature
3. Add a template or improve DX
4. Open a PR

New templates especially welcome — each niche helps more businesses deploy voice AI.

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤ by Prince Pal