Quickstart

Fork, configure DB and vars, run the Self-Host kit with your own LLM.

Prerequisites

  • Node.js 20+ and pnpm
  • PostgreSQL 16+ with pgvector
  • LLM API key (Anthropic for chat; OpenAI optional)

Clone and install

git clone https://github.com/Humaner-inc/humaner.git
cd humaner
pnpm install

Environment

  • Copy apps/dashboard/.env.example → .env.local
  • Set NEXT_PUBLIC_DEPLOYMENT_MODE=oss
  • Set DATABASE_URL, AUTH_SECRET, NEXT_PUBLIC_APP_URL
  • Add ANTHROPIC_API_KEY (chat) and optional OPENAI_API_KEY
  • Configure EMAIL_* or use console OTP in development

Start

pnpm --filter @humaner/dashboard exec prisma migrate deploy
pnpm --filter @humaner/dashboard dev

Next

Self-hosting agent brief

Full BYO setup (Markdown).

Local development

Monorepo paths and what you can change.