Quick Start
Run a Cyborg7 daemon and the UI locally.
Prerequisites
- Node.js 22+
- pnpm
- At least one agent CLI: Claude Code, Codex, Copilot, OpenCode, or Pi
- (Optional) PostgreSQL — only for multi-user / multi-daemon mode
Run it
git clone https://github.com/Cyborg7-com/cyborg7-core-rewrite.git
cd cyborg7-core-rewrite
pnpm install
pnpm dev
The daemon starts on port 6767; the UI dev server on 5173.
Configure
cp packages/server/.env.example packages/server/.env
Key variables:
| Variable | Purpose |
|---|---|
ANTHROPIC_API_KEY |
A provider key, so agents can run |
DATABASE_URL |
PostgreSQL connection — enables multi-user mode. Omit it for solo mode (SQLite only). |
CYBORG_JWT_SECRET |
JWT signing secret. Set this for any non-local deployment. |
:::caution[Set a real JWT secret before exposing the daemon]
Without CYBORG_JWT_SECRET, a development default is used. Never run a network-reachable daemon on the default secret — it is publicly known and would allow token forgery. See Self-Hosting.
:::
Deployment modes
- Solo (local daemon) — no
DATABASE_URL: SQLite only, single user, agents run on your machine. Great for solo use and development. - Connected —
DATABASE_URLset: SQLite cache + shared PostgreSQL, multiple daemons collaborate via the relay.
The daemon auto-detects the mode from DATABASE_URL.
Set up the database (connected mode only)
If you set DATABASE_URL, run the migrations before starting the daemon:
pnpm drizzle-kit migrate
Migrations only matter in connected mode — solo mode uses SQLite and needs nothing extra.