Hermes Agent 的本地优先桌面客户端，基于 Electron + React + TypeScript 构建。
社区项目，非 Hermes Agent 官方客户端。
Hermes Forge 为 Windows 与 macOS 提供统一的 Hermes Agent 桌面界面，覆盖安装部署、模型配置、任务执行、文件附件、权限审批与自动更新，无需手动维护 CLI 环境。
核心能力：
- 零配置 onboarding — 自动检测 Git、Python、Hermes Agent 等依赖缺失，提供一键修复或自动安装。
- 模型同步 — 桌面端模型配置实时同步至 Hermes CLI 与 Gateway 运行时，避免多端配置漂移。
- Windows 原生桥接 — 文件操作、PowerShell、剪贴板、截图、窗口管理与键鼠自动化，统一走主进程审批服务。
- Kanban 任务看板 — 完整任务生命周期管理，集成 Gateway 调度器，支持拖拽与实时诊断。
- 连接器 Gateway — 支持微信扫码、QQ Bot 与飞书多机器人配置；飞书 Bot 可绑定独立 Agent profile 与隔离运行目录。
- 自动更新 —
electron-updater+ GitHub Releases，支持静默检查、后台下载与进度追踪。
| 平台 | 下载 |
|---|---|
| Windows (x64) | Hermes-Forge-x.y.z-x64.exe |
| macOS (Apple Silicon) | Hermes-Forge-x.y.z-arm64.dmg |
当前为未签名二进制，首次启动时系统安全提示为预期行为。
环境要求：Node.js 20+、npm、Git、Python 3.10+
git clone https://github.com/Mahiruxia/hermes-forge.git
cd hermes-forge
npm install
cp .env.example .env
npm run devnpm run check # TypeScript
npm test # Vitest
npm run build # 生产构建Hermes 根目录按以下优先级解析：
- 应用设置中保存的路径
HERMES_HOMEHERMES_AGENT_HOME~/Hermes Agent<project-root>/Hermes Agent
构建时可通过环境变量覆盖：
HERMES_INSTALL_REPO_URL=https://github.com/NousResearch/hermes-agent.gitsrc/
main/ Electron 主进程、IPC、配置、密钥、连接器与原生服务
preload/ Renderer 安全桥接层
renderer/ React UI、工作台、设置中心、连接器面板
adapters/ Hermes CLI 适配、输出解析、启动元数据
process/ 任务运行器、命令运行器、快照、工作区锁
setup/ 首启体检、自动安装、依赖修复
updater/ GitHub Releases 自动更新
security/ 路径校验、权限常量
shared/ 类型、Schema、IPC 通道
设计原则：
- Hermes-only — 单引擎执行，无多引擎分支。
- 主进程可信边界 — 密钥、文件系统、子进程、Gateway 与原生能力集中于主进程。
- 白名单 IPC — Renderer 仅通过显式 Preload API 与主进程交互。
- 可恢复首启 — 依赖缺失时给出可操作的修复路径，而非堆栈错误。
- 本地优先 — 会话、附件、快照与日志默认留存于用户本机。
欢迎提交 Issue、Discussion 与 Draft PR。当前优先方向：
- 首启与依赖修复体验
- Windows 物理机兼容性
- 连接器 Gateway 长期运行稳定性
- 飞书 / QQ Bot runtime adapter 与多实例状态诊断
- Windows 桥接审批 UX 与审计展示
- Electron E2E / smoke 测试
- 代码签名与 release provenance
npm run check && npm test详见 CONTRIBUTING.md 与 SECURITY.md。
MIT