AI-powered voice booking agent platform. Businesses create voice agents that handle reservations and bookings via real-time phone conversations, integrated with Google Calendar. Built on Gemini Live API for bidirectional native audio streaming.

apps/
  web/        → Next.js 15 dashboard & API (port 3005)
  agent/      → Fastify 5 voice agent server, Gemini Live API (port 8080)
  widget/     → Embeddable voice booking widget (port 3006)
  call/       → WhatsApp-style direct call link app (port 3009)

packages/
  db/         → Prisma schema + client (PostgreSQL)
  shared/     → Shared constants and types
  ui/         → Shared UI components (shadcn/ui)
  typescript-config/
  eslint-config/

• Node.js >= 20
• pnpm >= 10.4
• PostgreSQL (local or Cloud SQL)
• Google Cloud account with:
  • Gemini API key (for voice agent + research)
  • Google Places API key (for location search)
  • Google OAuth 2.0 credentials (for calendar integration)

pnpm install

cp apps/web/.env.example apps/web/.env

apps/web/.env

# Auth
SESSION_SECRET=            # At least 32 characters (openssl rand -base64 48)
AUTH_USERNAME=admin         # Default admin username (lazy-seeded on first login)
AUTH_PASSWORD=changeme      # Default admin password (lazy-seeded on first login)
ALLOW_SIGNUP=false          # Set to "true" to allow new user registration

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/liveagent

# Agent Service
NEXT_PUBLIC_AGENT_WS_URL=ws://localhost:8080
AGENT_SERVICE_URL=http://localhost:8080

# Google Cloud
GOOGLE_API_KEY=             # Gemini API key
GOOGLE_PLACES_API_KEY=      # Google Places API key

# Google OAuth (Calendar integration)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# Widget
NEXT_PUBLIC_WIDGET_URL=http://localhost:3006
NEXT_PUBLIC_DEMO_AGENT_ID=  # Agent ID for landing page demo

apps/agent/.env

GOOGLE_API_KEY=             # Same Gemini API key
DATABASE_URL=postgresql://user:password@localhost:5432/liveagent
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
PORT=8080

pnpm db:generate   # Generate Prisma client
pnpm db:push       # Push schema to database

1. Gemini API key — Google AI Studio — add to both apps/web/.env and apps/agent/.env
2. Places API key — Google Cloud Console — add to apps/web/.env

1. Go to Google Cloud Console
2. Create an OAuth 2.0 Client ID (type: Web application)
3. Add authorized redirect URI: http://localhost:3005/api/agents/[id]/calendar/callback
4. Enable the Google Calendar API in your project
5. Copy Client ID and Client Secret to both .env files

pnpm dev

Run individual apps:

pnpm --filter @liveagent/web dev      # Web dashboard
pnpm --filter @liveagent/agent dev     # Agent server
pnpm --filter @liveagent/widget dev    # Widget
pnpm --filter @liveagent/call dev      # Call app

pnpm db:generate   # Regenerate Prisma client after schema changes
pnpm db:push       # Push schema to DB (dev, no migrations)
pnpm db:migrate    # Run migrations (production)
pnpm db:studio     # Open Prisma Studio GUI

1. Create an agent in the dashboard — configure business name, type, voice, greeting, and instructions
2. Connect Google Calendar — OAuth flow links your calendar for real-time availability checking and booking
3. Voice calls — The agent service uses Gemini Live API (@google/genai) for real-time bidirectional audio streaming. Callers speak naturally; the AI checks availability and creates bookings via function calling (check_availability, create_booking, reschedule, cancel)
4. Widget — Embed a voice booking widget on any website with a single <script> tag
5. Call link — Share a direct call URL (e.g., call.liveagent.dev/joes-barbershop) via social bios, QR codes, or SMS
6. Playground — Test and customize the widget appearance and agent behavior in the dashboard

Authentication uses iron-session encrypted cookies with credentials stored in PostgreSQL (bcrypt-hashed passwords).

• Default admin user is lazy-seeded on first login using AUTH_USERNAME and AUTH_PASSWORD env vars
• Signup is disabled by default (ALLOW_SIGNUP=false)
• All data is single-tenant with orgId="default"

A single terraform apply builds all Docker images in Cloud Build and deploys everything to Cloud Run. No local Docker required.

• Terraform >= 1.5
• gcloud CLI authenticated (gcloud auth login && gcloud auth application-default login)

These are enabled automatically by Terraform:

# 1. Configure
cd infra
cp terraform.tfvars.example terraform.tfvars
# Edit terraform.tfvars with your values

# 2. Initialize Terraform
terraform init

# 3. Deploy everything (builds images in Cloud Build + deploys to Cloud Run)
terraform apply

That's it. Terraform will:

1. Enable all required GCP APIs
2. Create Artifact Registry repository
3. Build all 4 Docker images in Cloud Build (no local Docker needed)
4. Create Cloud SQL PostgreSQL database
5. Run Prisma schema push via Cloud SQL Proxy (automatic)
6. Deploy 4 Cloud Run services (web, agent, widget, call)
7. Configure service accounts and IAM

cd infra
terraform output web_url      # Dashboard
terraform output agent_url    # Voice agent WebSocket
terraform output widget_url   # Embeddable widget
terraform output call_url     # Direct call link app

To show a live voice widget on the landing page:

1. Create an agent in the dashboard
2. Set demo_agent_id in terraform.tfvars with the agent ID
3. Run terraform apply again

After code changes, just run terraform apply again. It rebuilds all images in Cloud Build and updates the Cloud Run services.

This project is licensed under the GNU General Public License v3.0.