個人 GitHub 帳號下公開儲存庫的擁有者可以登入並驗證所有權,自行管理介紹,無需管理員核准。
登入並產生驗證檔案,在 30 分鐘內將其提交至此儲存庫的預設分支。其他分支或分叉儲存庫中的檔案無效。然後在下方檢查檔案,即可無需管理員核准直接管理專案。請保留檔案以維持管理權限。
如需登入,將前往登入頁面。登入後請回到此處,再次點擊所選的驗證按鈕。
在專案資料夾中執行 /nomorevibe verify,即可驗證所有權並自行管理介紹。
一分鐘完成驗證製作者的介紹僅有上面的一句話。 更多詳情請閱讀儲存庫 README。 儲存庫 README ↗
正在載入完整 README。
檢視完整 README ↗Own your AI. An open blueprint for building personal AI systems you own. Keep your memory, swap everything else.
We will soon rely on personal AI systems in every area of our lives. We should own them, so they always work in our interest, and the wealth AI creates flows far and wide instead of to a few Big Tech platforms.
Not an app, and not a framework you install. A blueprint, plus a starter kit to build from.
personal-ai-architecture-spec.md): what every PAA system must promise, including product stories, with known gaps tracked separately.overview.md): how the system works, its principles, decisions, component specifications, and explanatory background.contracts/): the exact OpenAPI and JSON Schema shapes code must match, plus canonical examples.conformance/): language-neutral checks and review guidance that prove a system conforms.47d6471 and pass the shared-validator and native checks. After release, use the v1.0 tag as the architecture source. See template readiness for exact template commits and limits. These checks prove named starter paths, not full product conformance.| Language | Starter |
|---|---|
| TypeScript | ts-architecture-template |
| Python | python-architecture-template |
| Go | go-architecture-template |
| Rust | rust-architecture-template |
| Java | java-architecture-template |
These are implementation starters, not qualified products. Each repository names the paths its tests exercise and the work needed for a complete deployment. Check its pin against PAA main before starting a new build.
For the rc.2 newcomer run, use TypeScript template commit b70ef42 and the PAA v1.0 tag. The contract pin is 47d6471. This candidate passed a controlled local Gateway-to-external-MCP call and the shared validator. Dave W's independent rerun of this candidate passed the six builder checks, the two rc.2 blocker checks, and the full verification suite. The earlier rc.1 independent retest remains historical evidence.
Four components and two APIs:
| Part | What it does |
|---|---|
| Your Memory | All your data, in files you own. Everything else depends on it; it depends on nothing. |
| Agent Loop | Calls the model, runs the tools it asks for, and repeats until the job is done. |
| Gateway | One front door for every interface. Start on the web, pick up on your phone. |
| Auth | Controls who and what gets in. It checks every request and every tool call. |
| Gateway API | How interfaces connect. Anything that speaks it plugs in. |
| Model API | How models connect. Which model and provider to use is your preference; a failure never quietly switches either choice. |
| I want to... | Start here |
|---|---|
| Understand the architecture | Architecture overview |
| Look up an unfamiliar term | Decision glossary |
| Build from a tested starter | Choose a language template (current-main status) |
| Build with an AI coding agent | AGENT.md, the architecture and a language template |
| Build one component | Its architecture spec, contracts and conformance checks |
| See what every system must promise | Product spec |
| Check my system conforms | Conformance guide |
To run this repository's Python contract and conformance checks, install the declared dependencies first. The conformance guide also provides a compatible dependency set for package indexes missing the primary pin.
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -r requirements-ci.txt
python3 scripts/check-contracts.py
python3 conformance/runner.py
BrainDrive is a personal AI assistant you own and control, built on all four PAA components by the team that wrote this architecture. Built something on PAA? Share it on the forum.
We welcome pull requests for documentation, contracts and specification improvements. See CONTRIBUTING.md.
MIT. See LICENSE.
| Check for lock-in | Lock-in gate |