Deployment & Local Setup

Local Development Setup

Prerequisites

• Node.js 18+
• Python 3.11+
• PostgreSQL with pgvector extension
• Redis server
• API keys: Supabase, Gemini, Resend. Deepgram is needed only if you run the legacy WebSocket fallback pipeline.

Backend

cd backend
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env       # Fill in all keys
alembic upgrade head
python scripts/seed_demo.py
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
cp .env.local.example .env.local
npm run dev

Production Deployment

• Frontend: Deployed and hosted on AWS Amplify.
• Backend: Containerized via Docker. Can be deployed to Google Cloud Run or standard Kubernetes.
• Database: Managed PostgreSQL (e.g., Supabase DB or AWS RDS) with pgvector.
• Background Jobs: APScheduler runs concurrently with FastAPI in the same container.