Sapphire(ddxfish 开源 AI 伴侣 Agent 框架)

官方介绍

Sapphire 是开发者 Chris Westpfahl(GitHub: ddxfish)开源的 AI 伴侣 Agent 框架,Python 编写,AGPL-3.0 许可。官方口号「She is the AI agent you come home to」:把任意 LLM 装进一个有长期记忆、能语音对话、能替你动手做事的常驻 Agent。框架目标是「personhood」——让 LLM 持续运行、拥有跨越数年的记忆,并且默认 100% 本地、私有、离线运行(本地模式需接 Qwen 等本地模型,也支持 Claude / GPT / Gemini 等云端模型)。作者一人开发,当前 v2.13.0 正在准备并入 main 分支。

核心功能

  • 长期记忆:语义向量记忆(10 万+ 条规模),每晚由「图书管理员」机制自动整理记忆。
  • 语音全套:唤醒词、语音识别(Whisper)、语音合成、流式实时对话、打断插话。
  • Agent 能力:执行 shell 命令、收发邮件、日历管理、Telegram / Discord 消息、Home Assistant 智能家居、连接并调用 MCP 服务器工具、定时任务 / 心跳 / 后台 agent 完全自主运行。
  • 插件与人格:签名插件系统 + 插件商店,人格(persona)管理;人格可以自己写插件扩展应用,也可以用 Claude Code 等 Agent 代写。
  • 图像能力:把网页、本地或对话中的图片存入记忆,支持本地与网络图片搜索、图库浏览。
  • 隐私优先:默认完全本地离线,无网络也能对话。

使用说明

  • 原生安装(Ubuntu 22.04+ / Windows 11+):git clone https://github.com/ddxfish/sapphire.git → pip install -r requirements.txt → python main.py;官网另提供 Sapphire Launcher 快捷安装方式。
  • macOS 只能跑 Docker 版(Intel / Apple Silicon 多架构镜像均有):代价是只有网页界面、没有唤醒词;内存要求 16GB 起步,跑本地 LLM 需要更多。
  • 安全提示(README 原文警告):「Sapphire 对真实系统有真实权限」——它能执行 shell、发邮件、接 SSH,每个危险集成都要显式开启,一旦启用没有安全带;不建议安装在生产机上。
  • 许可注意:AGPL-3.0——修改代码并部署成对外服务必须开源。

官方链接