Skip to content

Repository files navigation

AgentDesk ☎

License: MIT

Run a white-label AI voice-agent dashboard locally in ONE command — no database, no keys required to boot.

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. The dashboard, templates, businesses, and API all run with zero configuration; voice needs one API key.

make up

✨ What It Does

Feature Description
🎙 Live voice calls Real phone calls via Twilio or Exotel + LiveKit/Sarvam voice models
🧠 Niche templates Restaurant, dental, real estate, HR, e-commerce
📊 Dashboard Call logs, transcripts, bookings, analytics
🗄 Zero-install DB SQLite by default — no Postgres/Redis needed
🐳 One-command Docker make up boots API + dashboard, zero keys
🔒 Self-hosted Your data stays on your server

⚡ Quickstart (one command)

Zero-key dashboard (recommended)

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

That's it. No .env file, no API keys. Open http://localhost:3000 → dashboard ready. API docs at http://localhost:8000/docs.

Add voice (one key)

cp backend/.env.example backend/.env
# edit backend/.env and set SARVAM_API_KEY=sk_... (or OPENAI_API_KEY=sk-...)
make voice

The voice worker only starts with --profile voice, so a key-free make up never waits on a missing key.

Legacy manual path (no Docker)

# backend
cd backend && uv pip install --system -e . && uvicorn app.main:app --reload
# frontend (another terminal)
cd frontend && npm install && npm run dev

Docker deployment

git clone https://github.com/princepal9120/agentdesk
cd agentdesk
docker compose up

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

Live landing: https://agentdesk.princepal.dev


🧩 Templates

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

Template Use Case Agent Name
restaurant Table reservations, menu questions Bella
dental Appointment scheduling, insurance queries Aria
real-estate Lead qualification, property viewings Max
hr Candidate phone screening Sam
ecommerce Order tracking, returns, support Nova
custom Blank scaffold — fully configurable Alex

🏗 Architecture

agentdesk/
├── cli/               # (deprecated) use `make up` for local onboarding
├── 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: Sarvam Saaras + Sarvam-30B + Bulbul

Production stack:

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

About

Open-source white-label AI voice agent platform. Deploy AI receptionists for any business in minutes.

Resources

Contributing

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages