A personal AI system that helps you define, set, and reach your goals. Self-hosted and MIT licensed.
Website · Community · Architecture
BrainDrive is a personal AI system that partners with you to improve your career, relationships, fitness, finances — whatever matters to you. It interviews you to understand your goals, builds a structured spec and action plan, then works with you over time to follow through. Every conversation builds Your Memory, so the more you use it, the better it knows you.
Other AI tools chat. BrainDrive partners with you to get things done.
- For everyone — designed so anyone can start benefiting from AI, not just developers
- Compounding — your AI gets smarter with every interaction, and that value belongs to you
- Private — Your Memory lives on your machine, not in someone else's cloud
- A structured path to your goals — interview → spec → action plan → ongoing partnership
- Life areas built in — Career, Relationships, Fitness, Finance, plus create your own projects
- Your data stays yours — conversations, memory, and files live on your machine
- Any AI model — cloud models via API, local models via Ollama, or both
- One install — runs in Docker on Linux, macOS, and WSL
- MIT licensed — fork it, extend it, make it yours
Prerequisites: Docker Desktop (or Docker Engine + Compose on Linux).
git clone https://github.com/BrainDriveAI/braindrive.git
cd braindrive
./scripts/install.sh localOpen http://127.0.0.1:8080, create your account, and start talking to your BrainDrive.
Windows: Use
.\scripts\install.ps1 localin PowerShell.
- Land on BrainDrive+1 — your primary AI assistant. It knows everything across all your projects and helps you get started.
- Explore life areas — Career, Relationships, Fitness, Finance are ready to go. Create new projects for anything else.
- Interview — your AI asks the right questions to understand your situation, goals, and what success looks like.
- Spec — it organizes what it learned into a clear, structured document — your goals, context, and success criteria.
- Plan — the spec becomes an action plan with concrete steps, phases, and milestones.
- Partner — come back anytime. Your AI remembers everything and helps you stay on track, adjust plans, and make progress.
BrainDrive implements the Personal AI Architecture (PAA) — an open spec for user-owned AI systems. Every component is swappable. Your Memory is the foundation; everything else can be replaced.
You --> Web Client --> Gateway (Fastify) --> Agent Loop --> Models
| |
+-- Auth +-- Tools (MCP)
|
+-- Your Memory
(files on your machine)
The system runs as two Docker containers: an app server (Gateway + tools) and an edge proxy (web client + Caddy). Your Memory is stored as plain files in a Docker volume — fully portable, fully yours.
| Command | What it does |
|---|---|
./scripts/install.sh local |
First-time setup — builds images and starts everything |
./scripts/start.sh |
Start after stopping |
./scripts/stop.sh |
Stop without removing data |
./scripts/upgrade.sh local |
Rebuild from latest source |
./scripts/backup.sh |
Back up Your Memory and secrets |
./scripts/restore.sh memory <file> |
Restore from backup |
See installer/docker/README.md for production deployment, Windows equivalents, and advanced operations.
braindrive/
├── builds/typescript/ # Core: gateway, engine, auth, memory, web client
├── builds/mcp_release/ # MCP tool services
├── installer/docker/ # Docker compose, Dockerfiles, Caddy config
├── scripts/ # Top-level lifecycle commands
└── docs/ # Documentation
- Personal AI Architecture — the open foundation spec
- TypeScript, Fastify, React, Tailwind CSS
- Docker and Caddy for deployment
- MCP for tool integration
We welcome contributions. See CONTRIBUTING.md for how to get started, or join the discussion at community.braindrive.ai.
MIT — see LICENSE.
