Quickstart

Sadie runs as a single Next.js app backed by Postgres. You’ll be at localhost:3000 with seeded demo content in about five minutes.

Prerequisites

• Node.js 20+ (Sadie targets the active LTS)
• pnpm 10 (corepack enable or npm i -g pnpm)
• Postgres (local install, Docker, or a free Neon project)

Clone and install

git clone https://github.com/Miscreants/sadie.git
cd sadie
pnpm install

Configure environment

Copy .env.example to .env.local and fill in the two required keys:

DATABASE_URL="postgres://user:pass@localhost:5432/sadie"
# pick one provider, either works
OPENAI_API_KEY="sk-..."
ANTHROPIC_API_KEY="sk-ant-..."

For local Postgres setup see Local Postgres. For a managed option see Neon.

Migrate, seed, and run

pnpm db:migrate   # apply schema
pnpm db:reset     # wipe + reseed demo content
pnpm dev          # next dev on :3000

Open http://localhost:3000. You’ll land in the onboarding flow. Walk through it once to unlock the shell. After that you’re in Today with demo data.