Restaurant Voice Agent

An AI phone receptionist for restaurants. It answers calls, books, changes and cancels tables, answers menu and hours questions in two languages, and hands off to staff when asked. It is built entirely on free tiers and free models.

flowchart LR
    caller[Caller<br/>phone or browser] --> lk[LiveKit Cloud<br/>free US number]
    lk <--> agent[agent/<br/>Python voice agent<br/>VAD · STT · LLM · TTS]
    agent -- HTTP per contracts/openapi.yaml --> api[web/<br/>Next.js tool API]
    api --> db[(Supabase Postgres)]
    dash[web/ dashboard<br/>staff] --> db

Repository

Folder	What it holds	Docs
agent/	Real-time voice agent (Python, LiveKit Agents)	docs/agent.md
web/	Dashboard and tool API (Next.js, TypeScript, Supabase)	docs/web.md
contracts/	openapi.yaml: the only interface between the two	—

The two halves meet only at contracts/openapi.yaml, and each folder has a single owner (see .github/CODEOWNERS). For the full project context and rules, see CLAUDE.md.