Friend fork · forkmybrain.org · Operator governance · Quickstart · MCP setup · Acme demo · Fork guide · Licensing

Pipeline

17-step agent runtime with routing, grounding, corrections, and voice shaping — not a thin chat wrapper.

Pantheon

20 starter agents (Athena, Clio, Calliope, …). Extend via docs/PANTHEON_SLIM_TODO.md.

Evidence-first

Triangulation before outbound: KB, CRM, mail scope, proof registry. See docs/TRIANGULATION.md.

Brain OS is the public forkable skeleton — same multi-agent engine patterns as a private company operator, Acme synthetic data only.
Clone → private fork → your .env and production data never ship in this repo. Story + clinic: forkmybrain.org.

Architecture

  Cursor / Claude MCP          CLI (brain ask)
           \                         /
            v                       v
         +--------------------------------+
         |   Pantheon  +  17-step pipeline |
         +----------------+----------------+
                          |
            +-------------+-------------+
            v             v             v
        Qdrant        Neo4j         Postgres
        (vectors)     (graph)       (CRM)

Get started

git clone https://github.com/doshirush1901/brain-os.git
cd brain-os
cp .env.example .env    # OPENAI_API_KEY, optional VOYAGE_API_KEY
./scripts/macpro/bootstrap.sh
poetry run brain health
poetry run brain activate --trial
poetry run brain seed-acme
poetry run brain ask "Summarize the Acme demo CRM" --json

Acme wow path (ingest demo docs + account brief on Northwind): docs/ACME_DEMO_PATH.md

Step	Command
MCP in Cursor	`cp .cursor/mcp.json.example .cursor/mcp.json` then enable in Settings → MCP
MCP smoke test	`poetry run brain mcp`
Full MCP guide	docs/MCP_SETUP.md

What's included

Area	Path
Demo company	examples/acme/
Operator journey	examples/acme/journey.md
Mac bootstrap	scripts/macpro/bootstrap.sh
Starter agents	src/brain_os/pantheon.py

Licensing

Tier	Highlights
Community	Free fork · 500 doc cap · ~26 MCP tools · draft-only email
Pro / trial	`brain activate --trial` (14 days) or license key · full MCP

docs/LICENSING.md

Documentation

Doc	Description
Friend fork	Peer path: 90-minute win + week-1
Build your KB	Index → ingest your company docs
Operator governance	Draft-only send, Cloud vs desktop, autonomy ladder
Quickstart	Clone → bootstrap → first `brain ask`
Acme demo path	Ingest pack + Northwind account brief
Fork guide	Private fork checklist (7 days → month 1)
MCP setup	Cursor, Claude Code, Claude Desktop
Triangulation	Account evidence model
Brand assets	Logo, README hero, social preview
Changelog	Release notes
Git + AI	Commits, secrets, CI, maintainer export
Contributing	PR guidelines · Code of conduct
Security	Reporting issues

_{Brain OS · Maintained via export_brain_os.py in the private maintainer tree}