# hermes-desktop-windows **Repository Path**: gt6550/hermes-desktop-windows ## Basic Information - **Project Name**: hermes-desktop-windows - **Description**: Hermes Desktop windows — Hermes Agent 的windows桌面客户端。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 2 - **Created**: 2026-05-19 - **Last Updated**: 2026-05-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Hermes Desktop Windows > 基于 [fathah/hermes-desktop](https://github.com/fathah/hermes-desktop)(v0.2.2),由 **MiMo Claw** 操刀开发。 ![预览图](preview.png) [English](#english) | [中文](#中文) --- ## 中文 **Hermes Desktop Windows** — [Hermes Agent](https://github.com/NousResearch/hermes-agent) 的 Windows 桌面客户端。 基于 [fathah/hermes-desktop](https://github.com/fathah/hermes-desktop)(v0.2.2),通过 WSL 2 在 Windows 上运行 Hermes Agent,提供完整的中英双语界面。 ### 功能特性 - 🪟 **Windows 支持** — 通过 WSL 2 运行 Hermes Agent,文件读写走 `\\wsl$\` UNC 路径 - 🌏 **中英双语** — 完整的简体中文 + English 国际化(18 个翻译文件) - 📦 **Windows 安装包** — NSIS 安装程序,支持自定义安装路径 - 🤖 **国内大模型** — MiMo、DeepSeek、Qwen、智谱、Kimi 等一键配置 - 🔄 **自动获取模型** — 从 API 端点 `/v1/models` 自动拉取可用模型列表 - 📖 **内置教程** — 12 章节中文使用指南 - 🔧 **config.yaml 检测修复** — 自动检测配置损坏并一键修复 - 📋 **批量模型管理** — 多选批量删除模型 ### 系统要求 | 项目 | Windows | macOS / Linux | | -------- | -------------------------------- | -------------------------- | | 操作系统 | Windows 10 (Build 19041+) 或 11 | macOS 12+ / Ubuntu 20.04+ | | WSL | WSL 2 + Ubuntu 发行版 | — | | Node.js | 18+(仅开发构建) | 18+ | | Python | 3.11+(WSL 内,安装向导自动处理)| 3.11+(通过 uv 自动管理) | | 磁盘空间 | ~2 GB | ~1 GB | ### 安装 #### 第一步:安装 WSL(仅 Windows) 以 **管理员身份** 打开 PowerShell: ```powershell wsl --install -d Ubuntu # 重启电脑,首次启动 Ubuntu 时设置用户名和密码 wsl --list --verbose # 验证:应显示 Ubuntu Running 2 ``` #### 第二步:获取应用 **下载安装包(推荐)**:从 [Gitee Releases](https://gitee.com/jarain/hermes-desktop-windows/releases) 下载 `hermes-desktop-x.x.x-setup.exe`。 **从源码构建**: ```powershell git clone https://gitee.com/jarain/hermes-desktop-windows.git cd hermes-desktop-windows $env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" # 国内必须 npm install --ignore-scripts # 跳过原生模块编译 npm run dev # 开发模式 npm run build:win # 构建安装包 ``` #### 第三步:首次启动 启动画面 → 欢迎页 → 安装向导(~5-10 分钟)→ 服务商设置 → 主界面 ### 功能一览 | 功能 | 说明 | | ---------- | --------------------------------------------------- | | **对话** | 流式输出、斜杠命令(`/new` `/model` `/web` 等) | | **会话** | 搜索、恢复、删除历史对话 | | **记忆** | Agent 记忆 + 用户档案,跨会话持久化 | | **人格** | 通过 `SOUL.md` 定义助手性格 | | **模型** | 添加/删除/批量管理,支持云端和本地模型 | | **工具** | 单独启用/禁用 40+ 内置工具 | | **技能** | 安装社区技能插件 | | **定时任务** | 设置自动执行的计划任务 | | **网关** | 连接 Telegram、Discord、Slack 等 | | **助手** | 多 Profile 隔离,WSL 扫描导入 | | **设置** | 主题、语言、连接模式、凭证池、更新 | ### 项目架构 ``` src/ ├── main/ Electron 主进程 │ ├── index.ts 窗口创建、IPC 注册 │ ├── wsl.ts WSL 底层抽象(路径转换、平台检测) │ ├── wsl-exec.ts 统一 WSL 命令执行层(重试+降级+env 过滤) │ ├── gateway-manager.ts Gateway 生命周期状态机 │ ├── hermes.ts 聊天/API 逻辑 + re-exports │ ├── config.ts 配置管理 + provider 映射 │ ├── memory.ts 记忆管理(~/.hermes/memories/) │ ├── sse-parser.ts SSE 流解析器 │ ├── installer.ts 安装向导 │ ├── models.ts 模型管理 │ └── ... profiles, sessions, skills, tools, cronjobs ├── preload/ 安全桥接层 ├── renderer/src/ │ ├── screens/ 18 个功能页面 │ └── components/ 公共组件(Markdown、主题、i18n) └── shared/i18n/locales/ 中英双语翻译(各 18 个文件) ``` **WSL 工作原理**: ``` Electron App ├─ 文件读写 → \\wsl$\Ubuntu\home\\.hermes\ (原生 fs,无 wsl.exe) ├─ 命令执行 → wsl-exec.ts → spawnSync("wsl.exe", ...) ├─ Gateway → 脚本文件 + wslExecSync 启动,HTTP 通信 └─ API 通信 → HTTP localhost:8642 (SSE streaming) ``` ### 开发命令 ```powershell npm install --ignore-scripts # 安装依赖 npm run dev # 开发模式(热重载) npm run dev:win # Windows PowerShell(中文日志正确显示) npm run build # TypeScript 编译 npm run build:win # 构建 Windows .exe npm run build:mac # 构建 macOS .dmg npm run build:linux # 构建 Linux AppImage npm run lint # 代码检查 npm run typecheck # 类型检查 npm run test # 运行测试 ``` ### 常见问题 **Q: WSL 安装失败?** 以管理员运行 `wsl --install -d Ubuntu`,重启。仍失败则检查 Windows 功能中"适用于 Linux 的 Windows 子系统"和"虚拟机平台"是否启用。 **Q: `npm install` 卡住?** 设置镜像:`$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"` **Q: `npm install` 报错 Visual Studio?** 用 `npm install --ignore-scripts` 跳过原生模块编译。 **Q: 如何切换语言?** 设置 → 语言,或 Setup 页面右上角切换按钮。 **Q: 中文输入法问题?** Electron 可能有 IME 兼容问题,尝试切换输入法或使用微软拼音。 ### 许可证 MIT --- ## English **Hermes Desktop Windows** — a desktop companion for [Hermes Agent](https://github.com/NousResearch/hermes-agent) on Windows. Based on [fathah/hermes-desktop](https://github.com/fathah/hermes-desktop) (v0.2.2), running Hermes Agent via WSL 2 with a full Chinese + English bilingual UI. ### Features - 🪟 **Windows support** via WSL 2, file I/O through `\\wsl$\` UNC paths - 🌏 **Chinese + English** bilingual UI (18 translation files each) - 📦 **Windows installer** (NSIS) with customizable install path - 🤖 **Chinese LLM support**: MiMo, DeepSeek, Qwen, Zhipu, Kimi, etc. - 🔄 **Auto-fetch models** from `/v1/models` endpoint - 📖 **Built-in guide**: 12-section Chinese tutorial - 🔧 **Config repair**: auto-detect and fix corrupted config.yaml - 📋 **Batch model management**: multi-select delete ### Requirements | Item | Windows | macOS / Linux | | -------- | --------------------------------- | -------------------------- | | OS | Windows 10 (Build 19041+) or 11 | macOS 12+ / Ubuntu 20.04+ | | WSL | WSL 2 + Ubuntu distro | — | | Node.js | 18+ (dev build only) | 18+ | | Python | 3.11+ (in WSL, installer handles) | 3.11+ (auto-managed via uv)| | Disk | ~2 GB | ~1 GB | ### Installation **Step 1: Install WSL** (Windows only) ```powershell # Run PowerShell as Administrator wsl --install -d Ubuntu # Restart, then set up Ubuntu username/password ``` **Step 2: Get the App** Download installer from [Gitee Releases](https://gitee.com/jarain/hermes-desktop-windows/releases), or build from source: ```powershell git clone https://gitee.com/jarain/hermes-desktop-windows.git cd hermes-desktop-windows $env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/" npm install --ignore-scripts npm run dev # Dev mode npm run build:win # Build installer ``` **Step 3: Launch** — Splash → Welcome → Install wizard (~5-10 min) → Provider setup → Chat ### Features | Feature | Description | | ------------- | --------------------------------------------------- | | **Chat** | Streaming AI conversation with slash commands | | **Sessions** | Search, restore, delete conversation history | | **Memory** | Agent memory + user profile, cross-session persist | | **Persona** | Define agent personality via SOUL.md | | **Models** | Add/delete/batch manage cloud and local models | | **Tools** | Enable/disable 40+ built-in tools individually | | **Skills** | Install community skill plugins | | **Schedules** | Automated timed tasks | | **Gateway** | Connect Telegram, Discord, Slack | | **Profiles** | Multi-profile isolation, WSL scan import | | **Settings** | Theme, language, connection, credentials, updates | ### Development ```powershell npm install --ignore-scripts # Install deps npm run dev # Dev mode (hot reload) npm run dev:win # Windows PowerShell (Chinese log support) npm run build:win # Build Windows .exe npm run lint # Lint npm run typecheck # Type check npm run test # Tests ``` ### License MIT