awizemann/scarf

Scarf – Hermes AI 代理的 GUI 客户端 (macOS & iOS)

它是什么 – Scarf 是一个原生 Swift‑UI 应用程序，为 Hermes AI 代理平台提供图形前端。 它运行在 macOS 15+ 和 iOS 18.6+（配套的 ScarfGo 应用）上，通过普通 SSH 与 Hermes 服务器通信，读取代理的状态文件，并通过 hermes CLI 执行任何更改。

主要功能

• 完全可见性 – 仪表盘、会话历史、工具调用日志、令牌使用和成本明细、可搜索的活动流。
• 丰富交互 – 通过 Agent Client Protocol (ACP) 进行流式聊天，支持 Markdown、工具调用可视化或真实终端视图；语音聊天（设备端语音转文本和可选的 OpenAI 驱动实时语音）。
• 面向项目的工作流 – 每个仓库显示为一个 项目，拥有自己的仪表盘、看板、cron 任务、记忆文件、技能、模板和迷你应用。
• 多服务器支持 – 通过系统 SSH 配置管理任意数量的 Hermes 主机（本地 ~/.hermes/ 或远程机器）；每个服务器在独立窗口中打开。
• 配置界面 – 无需接触 YAML 文件，即可编辑 Hermes 配置、平台（Telegram、Discord 等）、模型（本地 Ollama、LM Studio、vLLM、llama.cpp）、MCP 服务器、网关、cron、密钥、插件等。
• 安全性 – Scarf 以只读方式读取 Hermes SQLite 数据库；所有写操作都通过官方 hermes CLI 进行，防止损坏。无需中间人服务。
• 跨平台伴侣 – iPhone 上的 ScarfGo 镜像 Mac UI，让您可以在手机上聊天、编辑记忆、运行 cron 和切换配置文件。SSH 密钥在设备上生成并存储在 iOS 钥匙串中。

典型工作流

1. 安装 Scarf（下载公证应用或从源代码构建）。
2. 通过 文件 → 打开服务器 → 添加 添加 Hermes 服务器（就像 ssh user@host）。
3. 选择一个项目 – UI 显示一个包含仪表盘、会话、cron、记忆、技能等的驾驶舱。
4. 与代理聊天、运行工具、编辑记忆文件或开始语音对话。
5. 使用 配置 面板添加平台、切换模型或管理 MCP 服务器。
6. 检查日志、运行诊断或向机器群推送更新。

隐私 – macOS 应用仅发送匿名化使用事件（不包括内容、路径或主机名）。iOS 应用不发送任何内容。实时语音模式仅在用户同意后将音频直接流式传输到 OpenAI。

安装 – 预构建二进制文件已签名，并通过 Sparkle 自动更新；源代码可以使用 Xcode 16 或提供的 local-build.sh 脚本构建。

适用人群 – 在自己的机器上运行 Hermes AI 代理，并希望使用原生、安全的 GUI 来监控、控制和交互，而无需编写 YAML 或使用终端的开发人员或高级用户。