快速语音

What You Can Build

• Inbound AI receptionists and support agents
• Outbound sales, reminders, collections, and follow-up workflows
• Appointment scheduling and qualification calls
• Knowledge-backed agents that answer from uploaded sources
• Campaigns that call many contacts and track outcomes
• Voice automation for healthcare, financial services, logistics, real estate, ecommerce, and operations teams

Quick Start

If your machine already has Docker, Docker Compose, Go Task, Node.js >=18, and Python 3, the local path is one command:

task up:dev

task up and task dev are aliases. Go Task treats spaces as separate task names, so prefer task up:dev for the explicit form.

First things to open:

• Console: http://localhost:3000
• Marketing site: http://localhost:3001
• API health: http://localhost:5000/api/v1/health
• API docs: http://localhost:5000/api/v1/docs
• AI API health: http://localhost:5555/health

On a fresh Ubuntu host, install the missing host tools first:

sudo apt-get update
sudo apt-get install -y docker.io docker-compose-v2 golang-go
sudo usermod -aG docker "$USER"
go install github.com/go-task/task/v3/cmd/task@latest
export PATH="$PATH:$HOME/go/bin"

Reconnect the SSH session after changing Docker group membership. Then run:

task up:dev

The task creates local env files from *.env.dev.example, activates pnpm@9.0.0, installs Node dependencies with the frozen lockfile, creates the AI Python virtualenv, starts Postgres and Redis through docker-compose.dev.yml, runs Prisma migrations, and launches the local services above.

The Docker Compose database credentials are dev-only placeholders (quickvoice / quickvoice) and the Postgres and Redis ports are bound to 127.0.0.1. Edit the generated env files after the first run if you need real Google, Stripe, LiveKit, Twilio, Telnyx, SMTP, or AWS credentials. Generated env files are ignored by git.

Optional local email testing is available through a Docker Compose profile:

docker compose -f docker-compose.dev.yml --env-file .env.dev --profile mail up -d mailpit

Useful individual tasks:

task doctor
task env:dev
task docker:up
task db:migrate
task db:seed -- --email you@example.com
task ci
task server:dev
task console:dev
task web:dev
task ai:api
task ai:worker

Common root commands:

pnpm build
pnpm lint
pnpm check-types
pnpm test
pnpm ci:local
pnpm audit:deps -- --audit-level high