Sapphire Blue AI

这个 Agent 能做什么，适合哪些场景？

Sapphire 是一个自托管的 agentic 框架，以 Web UI（https://localhost:8073）为主要界面，配有唤醒词、STT、TTS 与免提交谈模式。它以 LLM 为核心，通过组装式提示词、人格（Personas）、工具集（Toolsets）和语义向量记忆构建一个有个性的助手，并支持 AI 在运行时编写、校验并安装自己的工具。它通过插件与守护进程（daemons）接入 Discord、Telegram、邮件、Twilio 电话、Google Calendar、Home Assistant、SSH、比特币、MCP 等服务，并用心跳与定时任务实现自主运行。安装方式为 conda + pip 手动安装或 Docker 部署，后者无唤醒词但可隔离宿主系统。数据保存在本地 user/ 目录，可选使用云端 LLM 或本地 Ollama/LM Studio。

Sapphire 启动后运行 Python Web 服务（默认端口 8073），通过组装 Prompt 调用所选 LLM 提供商（Claude、GPT、Gemini、Fireworks 或任意 OpenAI/Anthropic 兼容端点）。它用 openWakeWord 检测唤醒词、Faster Whisper 转写语音、Kokoro（或 ElevenLabs）合成语音，实现流式语音对话与插话打断。记忆层对 10 万级以上条目做语义向量检索，Mind Palace 与 Librarian 在夜间整理记忆；Goals 系统记录带时间戳的进度日志。AI 可通过 Tool Maker 在运行时编写并安装新工具，通过 Code Harness 读写文件、搜索并执行命令，通过 SSH 插件远程执行命令（带安全黑名单）。插件系统提供 hooks、tools、voice commands、providers、daemons、apps 和主题，可从 GitHub 一键安装。守护进程与 webhooks 监听邮件、Discord、Telegram 等外部事件并按规则自动回复，心跳模式可执行晨间问候、闹钟与随机问候。

1. 自托管爱好者想要一个记得自己、早上能唤醒自己的语音家庭助手，并接入 Home Assistant 控制灯光与恒温器。
2. 开发者想要一个可插拔的 AI 框架，用插件为助手添加 Discord/Telegram 自动回复、邮件处理和定时任务。
3. 研究者希望用无线麦克风与扬声器组成便携语音工作伙伴，随时口述问题、让助手后台派生 Agent 做调研。
4. 需要隐私保护的用户启用 Privacy Vault，将聊天加密并强制使用标记为私有的模型，网络流量走 SOCKS 代理。
5. 创作者想搭建 RPG 式 AI 故事与游戏房间（Game Room / Story Engine），以自定义人格和语音进行桌面角色扮演。
6. 运维人员借助 SSH 插件与 Code Harness，让助手在受控黑名单下读取、编辑和运行远程命令。

如何安装或部署这个 Agent？

推荐使用 Sapphire Launcher 图形安装器（下载 .exe 或 .AppImage），它会代装 git、conda 与 Sapphire。手动安装需要 conda（Python 3.11）与 git：

conda create -n sapphire python=3.11 -y
conda activate sapphire
git clone https://github.com/ddxfish/sapphire.git
cd sapphire
pip install -r requirements.txt
python main.py

Linux 还需 sudo apt-get install libportaudio2 git，并需执行 conda TOS 接受命令（2025 年 7 月起强制）：

conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/msys2

Docker 替代方案（仅 Web UI，无唤醒词）：

mkdir ~/sapphire && cd ~/sapphire
curl -fsSL https://raw.githubusercontent.com/ddxfish/sapphire/main/docker-compose.yml -o docker-compose.yml
docker compose up -d

系统要求：Ubuntu 22.04+ 或 Windows 11+，Mac 仅支持 Docker；16GB+ 内存（含 TTS/STT），推荐 Nvidia GPU。

如何使用这个 Agent？

启动后打开 https://localhost:8073，首次运行会弹出设置向导配置 LLM 提供商（可选云端 API，或 Ollama/LM Studio 本地端点）。然后在 Chat 侧边栏选择 Provider，在 Toolsets 中选择或新建工具集，在 Personas 中创建包含提示词、工具集、语音与记忆范围的人格。说出唤醒词“hey sapphire”后进行语音对话。

常用配置入口：

# 更新
git pull
pip install -r requirements.txt

在 Settings → Help 中搜索文档；在 Schedule → Events 中安装 Daemon 以实现邮件/Discord/Telegram 自动回复；在插件商店一键安装社区插件；用 Import/Export 以 JSON 分享人格、提示词与工具集。所有数据保存在 user/ 目录，可从应用内备份与恢复。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题