Self-hosting & local setup

Prerequisites

Docker (for Supabase), Node 20+, and optionally the Lucy AI service.

1. Database

cd Supabase/docker && docker compose up -d   # Postgres :5432, API :8000

Apply the SQL files in supabase/ (run as supabase_admin for DDL). The settings table seeds platform configuration — fee, currency, terms, SMTP, KYC and Stripe keys are all rows there, editable from /admin/settings.

2. App

cd App
npm install
npm run dev        # http://localhost:3000
npx tsc --noEmit   # typecheck

Environment: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY (server-only — secret settings rows), LUCY_URL (+ LUCY_API_KEY) for the AI service, and Stripe keys via settings.

3. Lucy (optional but recommended)

Lucy runs as a separate service (default http://localhost:3001) and powers chat, screening interviews, posting drafts and dispute mediation. Set LUCY_URL accordingly; the model is selected via the lucy.lucy_model setting.

Where to read more

The repository docs/ folder is the full internal knowledge base — KNOWLEDGE-BASE.md is the index (architecture, database, payments, KYC, theming, testing, agent rules).