Orb：主動發起對話的自託管AI助手

Orb 是一個開源的自託管 AI 助手後端，它與配套的 iOS 應用協同工作，但最大的特點是：它不會等待你主動詢問，而是率先向你發送消息。它會在後台持續監控你的項目，維護一個不斷更新的情境模型，預測未來需求，並在真正值得你注意時才打擾你。

Orb 的核心能力包括：

• 語音服務器：通過 WebSocket 實現語音交互，無需喚醒詞即可進行自然對話。語音輸入使用本地 Whisper 模型，輸出採用神經 TTS，實現流暢的對話體驗。
• 代理中樞：一個輕量級循環，讓模型自行決定何時説話、何時行動，內置約 60 個工具，涵蓋天氣、郵件、文件、股票、屏幕、會話、任務、提醒、通知等。
• 多腦路由器：可在 Claude（通過你自己的 Claude Code CLI）、Grok、Codex 或本地模型之間無縫切換，保持統一人格。你可以在對話中途切換模型，而人格保持不變。
• 思維：在對話之間運行的一個進程，維護你生活和項目的情境模型，感知變化，做出預測，提出實際工作建議，並監督你批准的任務。
• 會話：將長時間運行的任務（如構建、研究、訓練）委託給後台代理，你可以通過手機隨時監控、發送消息或停止任務。
• 推送通知：使用 APNs 實現去重、硬限速、完整消息負載和投遞迴執，確保通知不會丟失。

運行方式

目前主要支持 Windows（macOS 後端正在開發中），需要 Python 3.11+。克隆倉庫後創建虛擬環境，安裝依賴，運行 setup.py 進行引導配置，然後啓動 supervisor.py。你需要為手機提供一個可訪問的地址（例如通過 Tailscale），然後在 iOS 應用中配對。項目提供了詳細的自行託管指南，你也可以使用 Claude Code 自動完成設置。

自帶一切

Orb 採用“自帶一切”的模式：你自帶模型訪問（默認使用 Claude Code CLI），自帶 APNs 推送密鑰，自帶 Gmail 應用密碼。後端從不內置或存儲任何憑據。所有變量都在 .env.example 和 SELF_HOSTING.md 中記錄。

架構

項目架構清晰：server_win.py 負責服務器、語音循環和通知；agent.py 是代理循環；brain.py 負責模型路由；tool_registry.py 和 otools/ 包含所有工具；mcp_http.py 和 orb_mcp.py 提供 MCP 接口；proactive_engine.py 驅動主動引擎；mind.py 管理會話間的自主行為；supervisor.py 保持後端運行並支持熱重載。

iOS 應用

iOS 應用已在 App Store 免費上架。應用本身是閉源的，但後端是開源的。應用通過 WebSocket 和 HTTP API 與後端通信，你也可以構建自己的客户端。

設計理念

• 本地優先：所有數據收集在你的機器上並保留在那裏。
• 自帶密鑰：後端從不提供憑據。
• 結構安全：自主表面無法訪問破壞性工具，任何影響世界的操作都需要你的明確批准，且每一步都記錄在日誌中。
• 沉默是金：主動層將“無話可説”視為正確的、一流的結果。

未來計劃

• 完全離線的本地模型層（Ollama / Qwen）作為一流默認選項。
• macOS 後端。
• 應用內二維碼配對。

許可

後端採用 MIT 許可證。Orb iOS 應用及品牌不在該許可範圍內。

項目由 ninjahawk 開發。