brainii.me GitHub

BrainII.me

我与我的数字分身共享的第二大脑

把文件、知识、代码收进自己家里的一台机器,AI 通过 MCP 直接读写它。 Your second brain, owned by you. — A brain that AI can actually read.

⭐ Star on GitHub 即将开放 · 敬请期待
The Problem

你的资料散在 7 个 App 里,AI 一个都读不到

文件在网盘、笔记在备忘录、代码在云仓库、灵感在聊天记录——每一家都把数据锁在自己的围墙里。

网盘 📁 笔记 📝 相册 🖼 代码 💻 收藏 🔖 🔒 🤖 AI —— 只能在墙外干瞪眼

市面上的自托管方案(Nextcloud / CasaOS / Runtipi / ZimaOS)全是 「App 优先、AI 外挂」—— 人打开界面用应用,AI 是事后追加的配件。

The Idea

一个大脑:文件 · 知识 · 代码,三层合一

BrainII 反过来做——AI 优先:数据层原生按 AI 的方式设计,人机共用同一个大脑。

🗂

文件层

网盘 · 相册 · 同步,所有文档一个家

🧠

知识层

笔记 · 资料 · 收藏,向量化可检索

💻

代码层

私有 Git,项目提交记录尽在掌握

三层统一暴露为 MCP 工具集——任何支持 MCP 的 AI 客户端(WorkBuddy、Claude、手机 AI…)即插即用。

MCP Toolset

五组工具,让 AI 真正「住进」你的大脑

这是 BrainII 与所有现成方案最大的差异点。

brain_files
读写 NAS 上的文件与目录,移动、归档、整理一句话搞定
把昨天那份方案挪到归档目录
brain_search
知识库语义检索(RAG),找资料不再靠翻文件夹
找出我写过的所有关于 OPC 的材料
brain_code
管理私有 Git 仓库与提交记录
看看上周 brainii 仓库改了什么
brain_capture
随手保存一句话、一张图、一个链接,先存下再说
把这个链接存进我的大脑
brain_schedule
AI 自动整理:去重、归档、生成周报
每周日把新增资料整理成周报
为什么不绑定整套 NAS?MCP 数据层可以独立部署——家里已有群晖、已有 Nextcloud 的朋友,只装 brainii 也能立刻获得「AI 大脑」。
Architecture

一图看懂:BrainII 怎么跑

一台迷你主机,全部服务容器化,一套 docker-compose 起全家。

BrainII 软件架构:Docker 容器布局 迷你主机 · Debian 12 + Docker · BrainII Tailscale 加密组网 · 零公网端口 Nextcloud 文件 · 相册 · 同步 Gitea 私有 Git OpenWebUI AI 对话前端 BrainII MCP 数据层(自研 · 开源核心) brain_files / brain_search / brain_code 知识引擎(RAG) 文档向量化 · 语义检索 · 摘要 统一账户(先单账户,开源版上 Authentik SSO)· 全程 HTTPS 数据存储 · 双盘镜像 4TB ×2 · RAID1 · 快照 异地备份 · restic 加密 每日增量 → 云冷存储 / 第二设备 任意 MCP 客户端:WorkBuddy · Claude · 手机 AI … ↑ AI 通过五组工具直接读写 ↓ 监控告警:磁盘 SMART · 服务探活 · 备份结果 → 微信/邮件推送
图 · 全部服务容器化:备份迁移都简单;AI 不是外挂,而是这层大脑的原住民
Roadmap

四步走到开源

地基 → 大脑 → AI 化 → 开源化,每周不超过两个晚上,验收后立即停手回归使用。

阶段一 · 地基 ● 当前阶段

硬件到位 → Debian + Docker + Tailscale + Nextcloud 最小可用

验收:在外用手机流量传一张照片 → 家里盘上出现 → 电脑同步到 ✅

阶段二 · 大脑 待启动

Gitea 私服 + 知识库目录规范 + 双盘镜像与快照 + restic 异地备份

验收:git push 到家里成功;快照恢复演练一次成功 ✅

阶段三 · AI 化 待启动

brainii MCP 数据层开发:文件 / 检索 / 代码三组工具打通 AI 客户端

验收:问「找出去年那份方案总结三点」,10 秒内答准 ✅

阶段四 · 开源化 待启动

一键安装脚本 + 完整文档 + 发布

验收:陌生人照 README 从零装到能用,1 小时内 ✅