自托管 AI 助手 Orb 后端开源，主打主动推送而非被动等待

Orb 是一款主打「主动找你说话」的 AI 助手，整个项目由两部分组成：闭源的 iOS App（已上架 App Store，免费）和本次开源的后端服务。后端采用 MIT 协议，代码托管在 GitHub（getorb/Orb-Backend），作者署名为 ninjahawk。

设计思路：不只是问答

与多数 AI 助手的「用户提问、AI 回答」模式不同，Orb 的后端在两次对话之间也会持续运行：维护一份关于用户生活与项目的「情境模型」，留意变化、做出预测、提出可执行的工作，并在需要时通过 APNs 推送主动联系用户。文档强调「沉默也是产品的一部分」——没有值得说的事，就不打扰。

多模型路由

后端内置一个「多脑路由器」，可以接入：

• Claude（通过用户本机已登录的 Claude Code CLI 调用，不存储任何 API Key）
• Grok、Codex CLI
• 任何兼容 OpenAI 接口的免费后端（通过 ORB_FREE_BACKENDS 切换）
• 本地模型（Ollama / Qwen 作为离线默认是路线图之一）

不同模型可在同一段对话中热切换，但人格（persona）保持一致。

核心能力

• 语音：WebSocket 语音环，本地 Whisper 听 + 神经 TTS 说，手机端无需唤醒词
• 智能体循环：单一循环中模型自行决定「说话 vs 行动」，内置约 60 个工具（天气、邮件、文件、股票、屏幕、会话、任务、提醒、通知等）
• 后台任务：长任务（构建、研究、训练）作为受监控的后台智能体，可在手机上查看进度、发消息、终止
• 推送：APNs 通知带去重、限速、完整 payload 与送达回执，避免静默吞消息

安全与自托管细节

• 本地优先：数据采集与处理均在用户机器上
• 自带密钥：后端不携带、不索要任何凭据
• 结构化安全：自治场景中不开放破坏性工具（直接缺席而非劝阻），所有对世界产生影响的动作均需用户显式批准
• 邮件工具为只读，使用用户自己的 Gmail 应用密码
• 推送使用用户自己的 Apple Developer .p8 密钥（已在 .gitignore 中屏蔽）

运行与架构

• 当前以 Windows 为主，macOS 后端规划中
• 需要 Python 3.11+，通过 git clone 与 venv 几步即可启动
• 推荐使用 Tailscale serve 暴露地址并与 App 配对；也可让 Claude Code 直接「帮我把 Orb 后端搭好」（仓库的 CLAUDE.md 写好了流程）

后端由多个独立模块组成：

• server_win.py：WS 语音环、HTTP API、脑调度、通知去重
• agent.py：决策说话/行动的薄循环
• brain.py：路由 Claude CLI、Grok/Codex、免费后端与本地模型
• tool_registry.py + otools/：每个工具一个文件
• mcp_http.py / orb_mcp.py：将工具面以 MCP 暴露（Claude 走回环 /mcp，Codex/Grok 走 stdio）
• proactive_engine.py：零 AI 采集、每日两次综合、跨重启存活的提醒调度
• mind.py：对话间代理，情境模型、预算化唤醒、审批门控
• stt.py / personas.py：本地 faster-whisper 听 + 神经 TTS 与人格定义
• supervisor.py：保活，支持代码变更后自重启

未来路线

• 完全离线的本地模型层（Ollama / Qwen）成为一等默认
• macOS 后端
• App 内 QR 配对

需要注意的是，本次 MIT 协议仅覆盖后端，iOS App 与「Orb」名称、品牌不在协议范围内。