Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
c8e1aae
feat(memory-backup): implement backup flow, scheduler, UI, tests, and…
DJJones66 Apr 7, 2026
36348a4
Merge branch 'main' into feat/memory-backup-implementation-20260407
DJJones66 Apr 7, 2026
93db747
Merge pull request #40 from BrainDriveAI/nav-managed-host-and-credits
DJJones66 Apr 8, 2026
c51bad0
Merge branch 'main' into feat/memory-backup-implementation-20260407
DJJones66 Apr 8, 2026
8ddd715
chore(build): preserve package artifact version updates (26.4.8)
DJJones66 Apr 8, 2026
810230a
Add developer journey section and fix PAA links
davewaring Apr 8, 2026
71672d4
Merge branch 'main' into feat/memory-backup-implementation-20260407
DJJones66 Apr 8, 2026
1cdc3ef
Merge pull request #41 from BrainDriveAI/feat/memory-backup-implement…
DJJones66 Apr 8, 2026
9f61da8
fix(installer): make bootstrap/install scripts macOS compatible
DJJones66 Apr 8, 2026
8fe944f
Merge pull request #42 from BrainDriveAI/fix/macos-bootstrap-installe…
DJJones66 Apr 8, 2026
0597c14
fix(installer): auto-handle Apple Silicon image platform fallback
DJJones66 Apr 8, 2026
00e89f2
Merge branch 'fix/macos-bootstrap-installer-compat'
DJJones66 Apr 8, 2026
e7e9e92
feat(settings): improve Ollama Docker defaults and URL help UX
DJJones66 Apr 9, 2026
0ca35c0
Merge pull request #43 from BrainDriveAI/feat/ollama-docker-host-defa…
DJJones66 Apr 9, 2026
121f1da
fix(client-web): prevent Plus One sidebar flicker on chat refresh
DJJones66 Apr 9, 2026
6f66a3e
Merge pull request #44 from BrainDriveAI/fix/plus-one-sidebar-flicker
DJJones66 Apr 9, 2026
d59abea
fix(chat): remove write approval cards and default to auto-approve
DJJones66 Apr 9, 2026
b36899f
Merge branch 'main' into fix/approval-write-cards-auto-approve
DJJones66 Apr 9, 2026
834bd08
Merge pull request #45 from BrainDriveAI/fix/approval-write-cards-aut…
DJJones66 Apr 9, 2026
746ea59
fix(context-window): add overflow recovery, warnings, and context com…
DJJones66 Apr 9, 2026
d310c4e
Merge pull request #46 from BrainDriveAI/fix/context-window-overflow-…
DJJones66 Apr 9, 2026
5548171
Updated gitignore
DJJones66 Apr 10, 2026
b88ceef
feat(installer): use prebuilt local images and run local startup upda…
DJJones66 Apr 10, 2026
dc63da5
chore: include remaining TypeScript and memory template updates
DJJones66 Apr 10, 2026
d3fb04a
Merge pull request #47 from BrainDriveAI/feat/docker-local-prebuilt-u…
DJJones66 Apr 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ builds/typescript/.your-memory.root-owned.backup/

# Dev notes / server-specific docs (contain IPs, internal ports)
builds/typescript/status.md
docs/Security/

# Local MCP server overrides
builds/typescript/mcp/servers.local.json
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ This builds and starts everything in Docker. See the [README](README.md) for pre

## Build on It

BrainDrive is built on the [Personal AI Architecture](https://github.com/BrainDriveAI/personal-ai-architecture) and is MIT-licensed. You can use it, extend it, and build on it without waiting for permission.
BrainDrive is built on the [Personal AI Architecture](https://github.com/Personal-AI-Architecture/the-architecture) and is MIT-licensed. You can use it, extend it, and build on it without waiting for permission.

## License

Expand Down
37 changes: 34 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ Other AI tools chat. BrainDrive partners with you to get things done.
- **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
- **Memory backup modes** — push memory snapshots to your own Git repo (manual or scheduled)
- **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
Expand Down Expand Up @@ -68,9 +69,17 @@ irm https://raw.githubusercontent.com/BrainDriveAI/BrainDrive/main/installer/boo
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
## For Developers

BrainDrive is built on the [Personal AI Architecture](https://github.com/Personal-AI-Architecture/the-architecture) (PAA) — an open, MIT-licensed standard for user-owned AI systems. Think of PAA as the spec and BrainDrive as the implementation. Anyone can build on the architecture; BrainDrive is our take on it.

| I want to... | Start here |
|--------------|------------|
| **Understand the architecture** | [Personal AI Architecture](https://github.com/Personal-AI-Architecture/the-architecture) — foundation spec, component contracts, conformance tests, zero lock-in by design |
| **Build with AI assistance** | [Architecture Primer](https://github.com/Personal-AI-Architecture/the-architecture/tree/main/docs/ai) — token-optimized reference files designed to hand directly to your AI agent. Compliance matrix, component primers, audit playbooks, canonical examples. |
| **Hack on BrainDrive** | [CONTRIBUTING.md](CONTRIBUTING.md) — fork, build, run tests, submit a PR |

BrainDrive implements the [Personal AI Architecture](https://github.com/BrainDriveAI/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.
## Architecture

```mermaid
flowchart LR
Expand Down Expand Up @@ -105,6 +114,28 @@ The system runs as two Docker containers: an app server (Gateway + tools) and an

See [`installer/docker/README.md`](installer/docker/README.md) for production deployment, Windows equivalents, and advanced operations.

## Memory Backup (MVP)

BrainDrive includes a local-only **Memory Backup** settings tab for backing up memory snapshots to your own HTTPS Git repository.

What it supports:

1. Configure repository URL, token, and frequency in **Settings -> Memory Backup**
2. Run immediate backup with **Save Now**
3. Run scheduled backups in `after_changes`, `hourly`, or `daily` modes
4. Restore memory from backup branch snapshots

Important safety behavior:

1. Restore is **memory-only**. Secrets are not restored from git backup.
2. Backup repository URL must be `https://` (SSH URLs are rejected).
3. Token is stored as a vault secret reference, not plaintext preferences.

Setup and validation instructions:

1. Operator notes: [`installer/docker/README.md`](installer/docker/README.md)
2. Step-by-step local test flow: [`docs/onboarding/getting-started-testing-openrouter-docker.md`](docs/onboarding/getting-started-testing-openrouter-docker.md)

## Operator Quick Usage

Support bundle script:
Expand Down Expand Up @@ -133,7 +164,7 @@ braindrive/

## Built With

- [Personal AI Architecture](https://github.com/BrainDriveAI/personal-ai-architecture) — the open foundation spec
- [Personal AI Architecture](https://github.com/Personal-AI-Architecture/the-architecture) — the open foundation spec
- TypeScript, Fastify, React, Tailwind CSS
- Docker and Caddy for deployment
- [MCP](https://modelcontextprotocol.io/) for tool integration
Expand Down
4 changes: 2 additions & 2 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

BrainDrive is built in five phases. Each phase makes your AI system more capable. At scale, something bigger emerges — when millions of owner-controlled AI systems connect, the sum becomes greater than the parts.

Built on the [Personal AI Architecture](https://github.com/BrainDriveAI/personal-ai-architecture) — an open, MIT-licensed foundation for building personal AI systems with zero lock-in.
Built on the [Personal AI Architecture](https://github.com/Personal-AI-Architecture/the-architecture) — an open, MIT-licensed foundation for building personal AI systems with zero lock-in.

---

Expand Down Expand Up @@ -126,7 +126,7 @@ Phase 2 builds the partnership. Phase 3 gets you off the keyboard.
BrainDrive is MIT-licensed and open source. We welcome contributions at every level:

- **Use it** — install BrainDrive, try the interview flow, report what works and what doesn't
- **Build on it** — the [Personal AI Architecture](https://github.com/BrainDriveAI/personal-ai-architecture) is designed for anyone to build on
- **Build on it** — the [Personal AI Architecture](https://github.com/Personal-AI-Architecture/the-architecture) is designed for anyone to build on
- **Contribute code** — check [open issues](https://github.com/BrainDriveAI/braindrive/issues) or pick something from the roadmap above
- **Join the community** — [community.braindrive.ai](https://community.braindrive.ai)

Expand Down
10 changes: 5 additions & 5 deletions builds/typescript/adapters/openai-compatible.json
Original file line number Diff line number Diff line change
@@ -1,25 +1,25 @@
{
"base_url": "https://my.braindrive.ai/credits/v1",
"model": "claude-sonnet-4-6",
"model": "claude-haiku-4-5",
"api_key_env": "AI_GATEWAY_API_KEY",
"provider_id": "braindrive-models",
"default_provider_profile": "braindrive-models",
"provider_profiles": {
"braindrive-models": {
"base_url": "https://my.braindrive.ai/credits/v1",
"model": "claude-sonnet-4-6",
"model": "claude-haiku-4-5",
"api_key_env": "AI_GATEWAY_API_KEY",
"provider_id": "braindrive-models"
},
"openrouter": {
"base_url": "https://openrouter.ai/api/v1",
"model": "anthropic/claude-sonnet-4.6",
"model": "anthropic/claude-haiku-4.5",
"api_key_env": "OPENROUTER_API_KEY",
"provider_id": "openrouter"
},
"ollama": {
"base_url": "http://127.0.0.1:11434/v1",
"model": "llama3.1",
"base_url": "http://host.docker.internal:11434/v1",
"model": "",
"api_key_env": "OLLAMA_API_KEY",
"provider_id": "ollama"
}
Expand Down
4 changes: 2 additions & 2 deletions builds/typescript/client_web/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion builds/typescript/client_web/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"name": "braindrive-client",
"description": "BrainDrive web client",
"private": true,
"version": "0.1.6",
"version": "26.4.8",
"type": "module",
"license": "MIT",
"repository": {
Expand Down
Loading