mariagorskikh/open-instinct

Open‑Instinct – 一个您可以透过短信互动的开源个人 AI 代理

它是什么

• 一个自托管的“个人代理”，您可以透过发送短信（iMessage、SMS 或电子邮件）与其互动。该代理运行在一个轻量级虚拟机（Maritime 平台上的 microVM）中，并能代表您执行现实世界的操作，例如建立文件、预约日历活动或进行购物。

运作方式

1. 身份与消息传递 – 您为代理提供一个电话号码。Inkbox（一项将电话号码/电子邮件映射到 agent‑to‑agent 端点的服务）会将该号码、电子邮件地址和安全端点传递给对方的代理。
2. 执行环境 – 一个小型网关会唤醒该代理，它运行在 Maritime 的 microVM 中。在 VM 内部运行的是 Pi 代理循环（核心编排引擎）。
3. 工具与整合 – Pi 循环透过以下方式与外部服务对话：
   • Composio – 用于 SaaS 工具（Notion、Google Calendar 等）的统一 API。
   • Stripe Link – 一个为购物建立单次使用卡片的钱包，因此模型永远不会看到您的卡片详细信息。
   • Claude Fable 5.1 – 驱动推理的预设 LLM。
4. 策略与信任 – 在使用任何工具之前，策略防护机制会检查请求代理的 信任层级（拥有者、合作伙伴、朋友、陌生人等）。权限以简单的英文表达（例如：“Sam 本周可以帮我们预订晚餐”）。
5. 输出 – 代理可以在其工作区中产生真实的产出物（PDF、文件）并将其作为附件发送回给您。

关键组件（仓库结构）

套件	角色
core	Pi 循环、内存、调度器、策略引擎
inkbox	消息传递转接器（iMessage、SMS、电子邮件）与 agent‑to‑agent 传输
computer	microVM 内部的桌面环境（Maritime desktopd）
apps	将请求转发至 Composio 支持工具的路由器
network	联系人管理、层级定义、邀请
payments	用于一次性卡片支付的 Stripe Link 整合
server	HTTP API (/health, /chat, /schedules)
gateway	用于配置多个代理的多用户注册/转发服务
cli	命令行界面 (instinct)
skills	定义代理行为的剧本

入门指南

• 需要 Node 22.19+ 和 pnpm 10。
• 克隆后，安装依赖，设定您的 Anthropic API 密钥，并使用您的姓名、电话、电子邮件和 handle 执行 pnpm instinct init。
• pnpm instinct dev 会启动本地代理；之后您可以透过 CLI 与其聊天，或者在配置 Inkbox 后，透过真实电话号码进行聊天。
• 对于生产环境，您可以将预先建置的 Docker 映像部署到 Maritime (pnpm instinct deploy)。网关服务可以为多个用户配置代理。

信任模型与支付

• 在执行任何工具之前，代码中会强制执行六个信任层级（拥有者 → 陌生人）。
• 购物由 Stripe Link 仲裁：代理请求一张单次使用卡片，您在手机上批准，交易完成后卡片即被丢弃。

状态

• 版本 0.1，包含测试套件（837 个测试）和端对端冒烟测试。
• 已经尝试过真实的 iMessage 和 Maritime 部署，但该项目仍被视为测试版。

谁适合使用？

• 希望拥有一个私有、自托管 AI 助理，且无需将凭证交给第三方服务即可代表其行事的开发者或进阶用户。
• 正在建立自订“agent‑to‑agent”工作流程，且重视信任层级与可审计性的团队。

授权条款 – MIT。