Getting Started

Two minutes from this page to a running Cerebro install. No Docker. No Python. No mcp.json to hand-edit.

1Download the installer

Grab the build for your OS from the latest Cerebro-Installer release. The download page on the dashboard picks your platform automatically.

Get the latest release

Windows is a signed .exe (~82 MB). Linux is an AppImage (~107 MB). macOS builds are in alpha — grab them from the same release page.

2Run the installer

The installer bundles the Cerebro backend, the FAISS index, the SQLite memory store, and the 49-tool MCP server. Nothing else to configure.

terminal
# Linux
chmod +x Cerebro-Installer.AppImage
./Cerebro-Installer.AppImage

# Windows
# Double-click Cerebro-Installer.exe
# (SmartScreen will warn on first run — More info → Run anyway.)

# macOS
# Drag the .dmg contents to Applications.
# First launch: right-click → Open.

On first launch the app creates ~/.cerebro/ for your memory store. Nothing leaves your machine.

3Connect to your Claude account

Cerebro talks to Claude through the Claude Code CLI, which uses your existing Pro or Max subscription. If the CLI isn't on your machine yet, install it and sign in.

terminal
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | sh

# Windows (PowerShell)
iwr -useb https://claude.ai/install.ps1 | iex

# Sign in (any platform)
claude login

Open Cerebro Desktop. If you're a Pro subscriber, paste the activation code from your dashboard when prompted. The Mind tab will start populating within a minute. That's it — you're done.

4Confirm it's working

Open the Mind tab. If you see your activity feed populating and the cognitive loop ticking, the install is healthy. For a deeper status check, the Settings page has a Run Diagnostics button that reports memory count, FAISS index health, MCP server status, and CLI connectivity.

Next Steps