Quickstart

Clone and install

git clone https://github.com/Brandonmchu/speakerweave.git
cd speakerweave
python3.12 -m venv api/venv && source api/venv/bin/activate
pip install -r api/requirements.txt
(cd web && npm ci)

Configure the environment

cp api/.env.example api/.env
cp web/.env.example web/.env

Set SUPABASE_URL, SUPABASE_SERVICE_API_KEY, SUPABASE_JWT_SECRET, and PORTAL_SESSION_SECRET in api/.env. Every variable the code reads is documented in the example file. A Supabase free-tier project is the shortest path (the API expects PostgREST + Storage); any Postgres works with equivalent roles.

Apply migrations and seed

for m in api/migrations/*.sql; do psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f "$m"; done
(cd api && python -m scripts.seed_demo seed)

The seed creates a complete demo conference in org_dev — the same workspace the public demo uses.

Run it

(cd api && uvicorn main:app --reload)   # http://localhost:8000
(cd web && npm run dev)                 # http://localhost:5173

Open /dev-login with the token printed by python scripts/mint_dev_token.py, or /demo for the public demo flow.

Open the demo as anyone

The seeded workspace has three audiences, and each one has a public door — no account, no email code:

Persona	Door	What it opens
Organizer	`GET /public/demo-entry/organizer`	A short-lived session token for the demo org (the same one `/public/demo-token` returns)
Reviewer	`GET /public/demo-entry/reviewer`	A review magic link — `{"kind":"path","path":"/review/…"}` — for a seeded evaluator with assignments in the open round
Speaker	`GET /public/demo-entry/speaker`	A portal magic link for a seeded speaker who still owes content

The landing page offers the same three doors as buttons. Links are minted with the real magic-link machinery (scoped to the demo org, 8-hour expiry, revocable), so what a visitor sees is what an invited reviewer or speaker sees. A deployment whose demo workspace was never seeded answers 404 rather than handing out a link into an empty portal.

Optional layers

Each activates with configuration alone and stays dormant otherwise:

Layer	Enable with
AI chat agent	`OPENAI_API_KEY` or `ANTHROPIC_API_KEY` (details)
Email delivery	`RESEND_API_KEY` (without it, mail writes local `.eml` files)
Clerk auth	`VITE_CLERK_PUBLISHABLE_KEY` + a `supabase` JWT template
Slack agent	Manifest at `api/slack_manifest.json`; Events + Interactivity on the same URL; `SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`, `SLACK_DEFAULT_ORG`, and the agent provider key (details)
Airtable sync	Per-organization settings in the UI (details)

The complete environment reference — every variable, grouped by feature, with swap guidance per layer — lives in configuration and tech stack & swap points.

Get started

AI surfaces

Integrations

Open the demo as anyone

Optional layers

​Open the demo as anyone

​Optional layers

Open the demo as anyone

Optional layers