hermes-desktop 是什么?

Hermes Desktop 是一个 Electron 桌面应用,作为 Nous Research 的 Hermes Agent 的图形界面「伴侣」:把原本要靠 CLI 手动维护的安装、提供商配置和日常使用,整合进同一个原生 GUI。首次启动会调用官方 Hermes 安装脚本把 Hermes 装到 ~/.hermes,再引导你选 API 提供商(OpenRouter/Anthropic/OpenAI 或本地 OpenAI 兼容端点),随后提供聊天、会话历史、档案切换、人格、记忆、技能、工具和设置等 GUI 面板。它本身不实现 agent 能力,代理行为和工具执行都依赖上游 Hermes Agent。当前为 0.4.x,仍在积极开发。

⭐ 12,897 Stars 🍴 1,465 Forks TypeScript MIT 作者: fathah 商业引流:中
来源:README.zh-CN.md 顶部说明/工作方式/相关项目;package.json version=0.4.5 查看 GitHub 仓库 →

为什么值得关注

上线约一个半月即超过 6.3k 星、760 fork,热度主要来自它服务的对象——Nous Research 的 Hermes 是社区高关注度的开源模型/agent,但其使用一直偏 CLI、门槛较高;Hermes Desktop 把安装、配置和聊天全部 GUI 化,并内置 LM Studio/Ollama/vLLM/llama.cpp 等本地模型预设,正好把一大批想用 Hermes 但怕折腾命令行的用户接了进来。较高的 fork 比例也反映出社区参与意愿。

来源:GitHub 6,350 stars / 760 forks,created 2026-04-02;README 定位与本地预设

核心功能

引导式安装与提供商配置

首次启动检查 ~/.hermes 是否已装 Hermes,没有则以 --skip-setup 运行官方安装脚本,再在 GUI 里选 OpenRouter/Anthropic/OpenAI 或本地 OpenAI 兼容端点,并把配置和 API Key 写入 Hermes 的配置文件(~/.hermes/.env、config.yaml)。

来源:README 工作方式/首次设置/说明
流式聊天与会话历史

聊天请求通过本地 Hermes CLI 发出,桌面端把响应流式回传到 UI;会话历史支持恢复和搜索,底层用 better-sqlite3 存储。

来源:README 主界面 Chat/Sessions;package.json deps better-sqlite3
档案(Agent)隔离与切换

通过档案切换隔离不同的 Hermes 环境,每个档案有独立的人格(Persona)、记忆(Memory)文件,可在 GUI 中查看和编辑。

来源:README 主界面 Agents/Persona/Memory
技能、工具与网关的图形化管理

GUI 提供对内置与已安装技能(Skills)的查看、工具集(Tools)的启停、以及 Hermes 消息集成网关(Gateway)的控制,把原本散落在 CLI/配置文件里的能力集中到面板。

来源:README 功能包含/主界面 Skills/Tools/Settings
本地模型预设 + 多平台打包

内置 LM Studio、Ollama、vLLM、llama.cpp 的本地预设(本地模型无需 API Key 但服务须先启动);用 Electron Builder 打包,提供 macOS .dmg、Linux .AppImage/.deb,支持自动更新。

来源:README 首次设置/安装;package.json deps electron-updater、devDeps electron-builder

技术架构

标准的 electron-vite + React 桌面应用结构,源码按 Electron 进程边界分层:src/main 是主进程(负责调用 Hermes 安装脚本、管理 ~/.hermes、起 CLI 子进程并代理流式响应、自动更新等),src/preload 是受控的 preload 桥,src/renderer 是 React + Tailwind 的前端 UI(App.tsx 与 components/,含 AgentMarkdown、ErrorBoundary 等,用 react-markdown + react-syntax-highlighter 渲染回复,i18next 做中英多语言),src/shared 放跨进程共享类型。会话等本地数据用 better-sqlite3 落盘。整体职责清晰:桌面端只做「安装/配置/会话/展示」的壳,真正的代理推理与工具执行下放给本地 Hermes CLI,这也是它和上游 Hermes Agent 的解耦点。

来源:tree(src/main|preload|renderer|shared、electron.vite.config.ts、electron-builder.yml);package.json deps;README 工作方式

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) electron / electron-vite / electron-builderelectron / ele… react + tailwindcssreact + tailwi… better-sqlite3 (会话存储)better-sqlite3 electron-updater (自动更新)electron-updat… i18next / react-i18next (多语言)i18next / reac… 引导式安装与提供商配置 流式聊天与会话历史 档案(Agent)隔离与切换档案(Agent)隔离与切… 技能、工具与网关的图形化管理技能、工具与网关的图形… 本地模型预设 + 多平台打包本地模型预设 + 多平台… hermes-desktop 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript框架Electron (electron-vite) + React + Tailwind CSS
electron / electron-vite / electron-…react + tailwindcssbetter-sqlite3 (会话存储)electron-updater (自动更新)i18next / react-i18next (多语言)react-markdown / react-syntax-highli…lucide-react
本地桌面应用(macOS .dmg、Linux .AppImage/.deb);依赖本地安装的 Hermes CLI(~/.hermes) 与所选模型提供商(云 API 或本地 LM Studio/Ollama/vLLM/llama.cpp)
来源:package.json dependencies/devDependencies;README 安装/构建

快速上手

普通用户直接到 Releases 下载对应平台构建:macOS 用 .dmg,Linux 用 .AppImage 或 .deb。macOS 因未代码签名/notarize,首次启动可能被拦,需 `xattr -cr "/Applications/Hermes Agent.app"` 或右键 Open。首次打开会自动检测/安装 Hermes 并引导选提供商。开发者本地:`npm install` → `npm run dev`;检查 `npm run lint` / `npm run typecheck`;构建 `npm run build` 或分平台 `npm run build:mac|build:win|build:linux`。需 Node.js+npm、类 Unix shell(跑 Hermes 安装器)和首次安装的网络。
来源:README.zh-CN.md 安装/开发

使用场景

适合:①想用 Nous Research 的 Hermes Agent 但不愿折腾 CLI 的用户,用图形界面完成安装、配置和日常对话;②想把 Hermes 接到本地模型(Ollama/LM Studio/vLLM/llama.cpp)离线使用、注重隐私的人;③需要管理多个 Hermes 档案(不同人格/记忆/工具集)并随时切换的玩家。不适合:不使用 Hermes Agent 的人(它只是 Hermes 的壳,离开上游没有独立价值)、以及需要 Windows 正式构建或企业级稳定性的场景(仍 0.4.x、macOS 未签名)。

来源:README 功能/首次设置/说明,结合定位推断

优势与局限

优势

  • 解决真实门槛:把 Hermes 从 CLI 体验升级为引导式 GUI,显著降低安装与配置成本
  • 本地模型支持到位:内置 Ollama/LM Studio/vLLM/llama.cpp 预设,离线/隐私场景友好
  • 功能面板完整:聊天、会话恢复搜索、档案隔离、人格/记忆/技能/工具/网关都做了图形化
  • 工程规范:electron-vite + React + Tailwind 标准结构,含 i18n、自动更新、husky、测试与 CI 配置
  • 与上游解耦清晰:桌面端只做壳,代理推理交给本地 Hermes CLI,职责边界明确

局限

  • 强依赖上游 Hermes Agent:自身不实现代理能力,上游变动或不可用时它也随之受限
  • 成熟度低:README 自述仍在积极开发、功能可能变化,版本停在 0.4.x
  • macOS 未代码签名/notarize,首次启动需手动 xattr 解除限制,体验和信任有折扣
  • Releases 中以 macOS/Linux 为主,Windows 支持(虽有 build:win 脚本)在文档里着墨少、成熟度待验证
  • 桥接安装脚本 + 本地 CLI 子进程的方式,对环境(类 Unix shell、~/.hermes 路径)有隐性假设,非标准环境可能踩坑
来源:README 说明/安装/开发;package.json;releases

最新版本

采用语义化版本,最新为 v0.4.5(2026-05-20),同期密集发布 v0.4.4/v0.4.3/v0.4.2(均在 2026-05 中下旬),属早期高频迭代。仓库带 changelogs 目录与 electron-updater 自动更新,发布以多平台桌面构建为主。

来源:GitHub Releases v0.4.5~v0.4.2;package.json version=0.4.5

总结评价

Hermes Desktop 的价值很直接:它把社区关注度很高、但一直偏 CLI 的 Nous Research Hermes Agent,包了一层完整、规范的桌面 GUI,安装引导、提供商配置、本地模型预设和档案/技能/工具管理都齐备,对想用 Hermes 又怕命令行的人是实打实的降门槛工具,这也是它一个半月冲到 6.3k 星的原因。但要认清它是「壳」:没有上游 Hermes 它没有独立意义,且自身还在 0.4.x、macOS 未签名、Windows 支持存疑。如果你正在用或想用 Hermes,它非常值得装;如果不用 Hermes,则没有理由单独关注它。

来源:综合 README 定位、tree 工程结构、版本与平台状态的事实判断

常见问题

hermes-desktop 是什么?

Hermes Desktop 是一个 Electron 桌面应用,作为 Nous Research 的 Hermes Agent 的图形界面「伴侣」:把原本要靠 CLI 手动维护的安装、提供商配置和日常使用,整合进同一个原生 GUI。

hermes-desktop 有哪些核心功能?

hermes-desktop 的核心功能包括:引导式安装与提供商配置、流式聊天与会话历史、档案(Agent)隔离与切换、技能、工具与网关的图形化管理、本地模型预设 + 多平台打包。

hermes-desktop 为什么最近很受关注?

上线约一个半月即超过 6.3k 星、760 fork,热度主要来自它服务的对象——Nous Research 的 Hermes 是社区高关注度的开源模型/agent,但其使用一直偏 CLI、门槛较高;Hermes Desktop 把安装、配置和聊天全部 GUI 化,并内置 LM Studio/Ollama/vLLM/llama.cpp 等本地模型预设,正好把一大批想用 Hermes 但怕折腾命令行的用户接了进来。

hermes-desktop 适合哪些使用场景?

适合:①想用 Nous Research 的 Hermes Agent 但不愿折腾 CLI 的用户,用图形界面完成安装、配置和日常对话;②想把 Hermes 接到本地模型(Ollama/LM Studio/vLLM/llama.cpp)离线使用、注重隐私的人;③需要管理多个 Hermes 档案(不同人格/记忆/工具集)并随时切换的玩家。

透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 17:41. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件