黑豹（天津）科技有限公司 HEIBAO · SOFTWARE & AI

Hermes Desktop：1.2 万 Star 的 Hermes Agent 图形化桌面伴侣

2026-06-12 14:15:19
标签人工智能AI智能体开源软件行业

Hermes Desktop 开源项目分析

仓库：github.com/fathah/hermes-desktop · License: MIT · ⭐ 12k+ · 🍴 1.3k+ · 上游：Hermes Agent

项目是什么

Hermes Desktop 是 Hermes Agent 的 原生桌面伴侣应用（Desktop Companion）。Hermes Agent 本身以 CLI/TUI 和消息网关为主，Hermes Desktop 将其能力 图形化：

  • 首次启动 引导安装 Hermes（调用官方 install.sh）
  • 流式 Chat UI（SSE、Markdown、工具进度、Token 用量）
  • 可视化配置 Provider、Skill、记忆、Cron、Gateway 等

适合不想手敲 hermes setup、希望「开箱即用 GUI」的用户与团队。

技术栈

组件 技术
桌面壳 Electron 39
前端 React 19 + TypeScript 5.9 + Tailwind CSS 4
构建 Vite 7 + electron-vite
本地存储 better-sqlite3（会话 FTS5 全文检索）
国际化 i18next（英/中/日/西语等）
测试 Vitest

核心功能

安装与连接

  • 本地模式：检测 ~/.hermes，缺失则自动安装 Git + uv + Python 3.11+
  • 远程模式：连接远程 Hermes API（URL + API Key），无需本机 Agent
  • 本地 Chat 走 http://127.0.0.1:8642 SSE 流式协议

工作区能力

模块 能力
Chat 22+ 斜杠命令、工具进度、Token/成本显示
Sessions FTS5 搜索、按日期分组、恢复历史
Profiles 多 Profile 隔离配置与环境
Skills / Tools 14 个 Toolset 开关、Skill 浏览安装
Memory Honcho、Mem0、Supermemory 等 Provider 配置
Schedules Cron 构建器，15 种投递目标
Gateway 16 种消息平台（含钉钉、飞书、企微、微信 iLink Bot）
Office Claw3d 3D 可视化界面
Settings 备份/恢复、日志查看、自动更新

支持的 LLM Provider

OpenRouter、Anthropic、OpenAI、Google Gemini、xAI、Nous Portal、Qwen、MiniMax、Hugging Face、Groq，以及 LM Studio / Ollama / vLLM 等 OpenAI 兼容端点。

与 Hermes Agent 的关系

层级 项目 职责
核心 Hermes Agent Agent 循环、工具执行、Gateway、Skill 标准
外壳 Hermes Desktop GUI 安装、配置、Chat、会话与运维可视化

Desktop 不替代 Agent 核心逻辑，而是降低使用门槛；Agent 升级后 Desktop 通过官方安装脚本同步。

快速开始

git clone https://github.com/fathah/hermes-desktop.git
cd hermes-desktop
npm install
npm run dev          # 开发模式
npm run build:mac    # 打包 macOS / win / linux

Windows 用户可下载 Release 安装包（首次可能触发 SmartScreen，需「更多信息 → 仍要运行」）。

适用场景

场景 价值
个人 AI 助手 GUI 聊天 + 记忆 + 定时任务，免 CLI
团队内网部署 远程模式连接统一 Hermes API 服务器
国内 IM 集成 钉钉/飞书/企微 Gateway 可视化配置
Hermes 生态推广 降低 Agent 上手成本，适合非开发者

局限与注意点

  1. 项目活跃开发中：README 注明功能可能变动，生产使用需锁定版本
  2. 依赖上游 Hermes：Agent breaking change 可能影响 Desktop 兼容性
  3. Windows 安装包未签名：SmartScreen 警告属预期行为
  4. Fedora RPM 无 GPG 签名：需 --nogpgcheck，且 RPM 不支持自动更新

黑豹点评

Hermes Desktop 补上了 Hermes Agent 生态的 「最后一公里」——从 19 万 Star 的 CLI Agent 到可双击打开的桌面应用。对黑豹这类做企业交付的团队，它适合作为 内网 AI 助手演示客户端：Remote 模式连统一后端，Gateway 配钉钉/飞书即可快速 POC。与 MoneyPrinterTurbo 代表的内容生产自动化不同，Hermes Desktop 代表 Agent 运维与交互的可视化，二者可组合进「研究 + 执行 + 触达」完整链路。

项目链接：https://github.com/fathah/hermes-desktop