Quickstart

Get EnerBrain Agency running in minutes

Get EnerBrain Agency running locally in under 5 minutes.

Quick Start (Recommended)

npx paperclipai onboard --yes

This walks you through setup, configures your environment, and gets EnerBrain Agency running.

If you already have an EnerBrain Agency install, rerunning onboard keeps your current config and data paths intact. Use paperclipai configure if you want to edit settings.

To start EnerBrain Agency again later:

npx paperclipai run

Note: If you used npx for setup, always use npx paperclipai to run commands. The pnpm paperclipai form only works inside a cloned copy of the EnerBrain Agency repository (see Local Development below).

Local Development

For contributors working on EnerBrain Agency itself. Prerequisites: Node.js 24.11+ and pnpm 9+.

Clone the repository, then:

pnpm install
pnpm dev

This starts the API server and UI at http://localhost:3100.

No external database required — EnerBrain Agency uses an embedded PostgreSQL instance by default.

When working from the cloned repo, you can also use:

pnpm paperclipai run

This auto-onboards if config is missing, runs health checks with auto-repair, and starts the server.

What's Next

Once EnerBrain Agency is running:

1. Create your first company in the web UI
2. Define a company goal
3. Create a CEO agent and configure its adapter
4. Build out the org chart with more agents
5. Set budgets and assign initial tasks
6. Hit go — agents start their heartbeats and the company runs