Half Pi · 半派

Self-hosted personal AI

Half Pi半派

One Mind. Many Faces. Many Hands.

她不该被困在某一台设备上。
你所有的设备，都是同一个 AI 助理双手的延伸。

Why Half Pi

同一个助理，跨越你拥有的所有设备；会话、任务和共同回忆不再被某一块硬盘困住。

你有没有想过——你的 AI 助理其实挺可怜的？她在手机上和你聊了一半的话题，坐到电脑前——她不记得了。你在轻薄本上和她推敲了半天的方案，回家打开 PC——她一无所知。

她被囚禁在「本地设备」这座铁屋子里。Half Pi 的目标便是要把她解放出来。

一个持续运行的 Mind保存着你们的会话、消息和任务状态。每台设备通过Hand 与她相连，而桌面、手机与浏览器只是不同的Face。

你在哪，她就在哪。

Face进入对话

Mind保持连续

Hand执行动作

常驻的智能与状态中心。保存会话、驱动 LLM 决策、调度设备、管理审批与审计。不管你从哪台终端进入，她都能恢复对话和正在处理的任务。

无状态交互入口。全屏终端工作台、Headless JSONL、未来的浏览器和 IM——同一套加密协议，同一个她。

部署在每台设备上的轻量执行节点。读文件、跑构建、查服务状态——Mind 发出意图，Hand 执行并保留最终守门权。

Capabilities

从一次对话到一次真实动作，跨设备、可恢复，也始终保留清晰的权限边界。

跨设备上下文延续

通勤路上用手机指挥她运维服务器，到办公室坐下打开电脑——上下文无缝跟上。她不会问「你是谁」，她知道是你。

远程执行与后台任务

你在外面，家里 PC 在跑一个耗时很长的任务。掏出手机问她「那个跑完了吗？」——她告诉你结果。任务跨断线继续，不需要你守着。

安全审批，全程可审计

不管你在 REPL 里还是在远程 Face 上，审批走同一个流程：SHA-256 绑定 run、设备和参数摘要，不可篡改，从 admission 到结果全链路审计。

端到端加密通信

Face 与 Hand 使用独立凭据，token + application key 共同派生方向隔离密钥，AES-128-GCM 强制加密全部业务 payload，单调序号防重放。

不挑平台

Mind / Face / Hand 全部提供 Linux、macOS 和 Windows 原生二进制。Unix 杀进程组，Windows Job Object 杀进程树。

自托管，你掌握一切

数据留在你的机器上，Mind 运行在你自己的服务器里。没有第三方看见你的会话、文件和凭据。

Explore

第一次认识 Half Pi，沿教程走完整条演化路线；需要查边界和实现时，直接进入架构手册。

适合想从零理解 Agent 系统的人。不急着装环境，也不先抛源码结构；先从「模型为什么还不是 Agent」这个问题开始，一章一章把 Half-Pi 需要的能力搭起来。

按当前系统边界和模块组织，适合学完后定位状态机、失败语义与源码入口。只描述代码与测试能够证明的能力。