Skip to content

BrainDriveAI/BrainDrive

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BrainDrive

License: MIT

A personal AI system that helps you define, set, and reach your goals. Self-hosted and MIT licensed.

BrainDrive — checking in on fitness goals

Website · Community · Architecture

What Is BrainDrive?

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

What You Get

  • 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

Quick Start

Prerequisites: Docker Desktop (or Docker Engine + Compose on Linux).

git clone https://github.com/BrainDriveAI/braindrive.git
cd braindrive
./scripts/install.sh local

Open http://127.0.0.1:8080, create your account, and start talking to your BrainDrive.

Windows: Use .\scripts\install.ps1 local in PowerShell.

How It Works

  1. Land on BrainDrive+1 — your primary AI assistant. It knows everything across all your projects and helps you get started.
  2. Explore life areas — Career, Relationships, Fitness, Finance are ready to go. Create new projects for anything else.
  3. Interview — your AI asks the right questions to understand your situation, goals, and what success looks like.
  4. Spec — it organizes what it learned into a clear, structured document — your goals, context, and success criteria.
  5. Plan — the spec becomes an action plan with concrete steps, phases, and milestones.
  6. Partner — come back anytime. Your AI remembers everything and helps you stay on track, adjust plans, and make progress.

Architecture

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.

Lifecycle Commands

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.

Project Structure

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

Built With

  • Personal AI Architecture — the open foundation spec
  • TypeScript, Fastify, React, Tailwind CSS
  • Docker and Caddy for deployment
  • MCP for tool integration

Contributing

We welcome contributions. See CONTRIBUTING.md for how to get started, or join the discussion at community.braindrive.ai.

License

MIT — see LICENSE.

About

A personal AI system that helps you define, set, and reach your goals. Self-hosted and MIT licensed.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors