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——修改代码并部署成对外服务必须开源。