Skip to main content

​
Developer Quickstart

Get the Unpod platform running locally and deploy your first voice agent. Choose the setup method that works best for you.

​
Prerequisites

Before you begin, ensure you have:
  • Node.js v20+ / npm v10+
  • Python 3.11+ (3.10+ for apps/super)
  • Docker and Docker Compose
  • Git
  • uv (only for apps/super)
The fastest way to get everything running: 
git clone https://github.com/parvbhullar/unpod.git
cd unpod
make quick-start    # Install deps, start Docker, run migrations
make dev            # Start frontend (port 3000) + backend (port 8000)

​
Option 2: Manual Setup

If you prefer full control over each step: 
# Install Node.js dependencies
git clone https://github.com/parvbhullar/unpod.git
cd unpod
npm install
Create Python venv for backend: 
python3 -m venv apps/backend-core/.venv
source apps/backend-core/.venv/bin/activate
pip install -r apps/backend-core/requirements/local.txt
Start infrastructure (PostgreSQL, MongoDB, Redis, Centrifugo): 
docker compose -f docker-compose.simple.yml up -d postgres mongodb redis centrifugo
Run migrations and start dev servers: 
cd apps/backend-core && python manage.py migrate --no-input && cd ../..
npm run dev
For detailed environment variable configuration, see the Configuration page.

​
Option 3: Docker Only (No Local Dependencies)

Starts everything in containers with working defaults: 
git clone https://github.com/parvbhullar/unpod.git
cd unpod
docker compose -f docker-compose.simple.yml up -d --build
Default admin: admin@unpod.dev / admin123

​
Access Points

Once running, the following services are available:
ServiceURL
Frontendhttp://localhost:3000
Backend APIhttp://localhost:8000/api/v1/
Admin Panelhttp://localhost:8000/unpod-admin/
API Serviceshttp://localhost:9116/docs
Centrifugohttp://localhost:8100

​
Verify It Works

  1. Open http://localhost:3000 in your browser
  2. Log in with the default credentials or create a new account
  3. Create a voice agent from the AI Studio
  4. Assign a phone number and make a test call

​
Next Steps

Configuration

Environment variables, development commands, and Docker setup.

Architecture

Understand the monorepo structure, tech stack, and how services connect.

Dev Platform Guide

Configure telephony, agents, and providers via the developer dashboard.

API Documentation

Programmatic access to agents, calls, numbers, and more.