Installation
Install the-brain on macOS and Linux in 2 minutes
One-Liner
curl -fsSL https://the-brain.dev/install.sh | bashThe installer auto-detects your OS:
- macOS: Bun CLI + menu bar app + LaunchAgents
- Linux: Bun CLI + remote mode with auth token
Prerequisites
- Bun (
curl -fsSL https://bun.sh/install | bash) - macOS with Apple Silicon (for MLX training — optional)
- Python 3.11+ and
uv(for MLX sidecar — optional)
Manual Install
git clone https://github.com/oskarschachta/the-brain.git
cd the-brain
bun install
bun run build
the-brain initInitialize with a Project
the-brain init --project my-app --work-dir ~/code/my-appEach project gets isolated memory, wiki, and LoRA checkpoints.
Remote Mode (Linux Server)
# On server
the-brain init --remote
the-brain daemon start
# → API on 0.0.0.0:9420, MCP on 0.0.0.0:9422
# On Mac client
export THE_BRAIN_REMOTE_URL="http://<server-ip>:9420"
export THE_BRAIN_AUTH_TOKEN="mb_<token>"
the-brain agentVerify
the-brain inspect --stats
# Memories: 0 | Graph nodes: 0 | Status: running