# 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** 操刀开发。

[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