Hermes Agent 安装到D盘教程

前言：为什么会有这篇教程

Hermes Agent 是 Nous Research 的开源 AI Agent 项目（CLI + 桌面端）。网上流传的"国内优化版安装脚本"会把官方流程改坏，导致一系列诡异报错。本文唯一结论：用官方安装脚本 + 环境变量换国内源 + 关键时刻挂代理，这是最稳的路径。

环境要求

项目	要求
系统	Windows 10/11（64 位）
磁盘	D 盘预留约 5GB（项目全部装 D 盘，C 盘零落盘）
网络	普通宽带 + 一个代理工具（安装过程有一段必须挂）
权限	普通用户即可，不要用管理员窗口

第一步：下载官方安装脚本

打开普通 PowerShell 窗口（不要管理员），执行：

New-Item -ItemType Directory -Force -Path 'D:\Hermes' | Out-Null
Invoke-WebRequest -Uri 'https://hermes-agent.nousresearch.com/install.ps1' -OutFile 'D:\Hermes\install_official.ps1' -UseBasicParsing

如果提示"禁止运行脚本"，先关掉窗口，用 powershell -ExecutionPolicy Bypass 重新打开再执行。

第二步：设置环境变量并一键安装

同样在普通 PowerShell 窗口，粘贴执行（一整行）：

$env:HERMES_HOME='D:\Hermes\hermes'; $env:HERMES_REPO_URL='https://cnb.cool/hermesagent-cn/hermes-agent-cn-mirror.git'; $env:UV_DEFAULT_INDEX='https://mirrors.aliyun.com/pypi/simple/'; $env:UV_PYTHON_INSTALL_DIR='D:/Hermes/pythons'; $env:UV_CACHE_DIR='D:\Hermes\uv-cache'; $env:NPM_CONFIG_REGISTRY='https://registry.npmmirror.com'; & 'D:\Hermes\install_official.ps1' -HermesHome 'D:\Hermes\hermes' -InstallDir 'D:\Hermes\hermes-agent' -SkipBrowser -SkipComputerUse

每个变量的作用：

变量	作用
`HERMES_HOME`	Hermes 的数据家目录，指向 D 盘（不设的话默认落 C 盘 AppData）
`HERMES_REPO_URL`	仓库地址换成 cnb.cool 国内镜像（GitHub 克隆慢/超时）
`UV_DEFAULT_INDEX`	Python 依赖源换成阿里云镜像
`UV_PYTHON_INSTALL_DIR`	Python 解释器安装目录指向 D 盘
`UV_CACHE_DIR`	uv 缓存指向 D 盘
`NPM_CONFIG_REGISTRY`	npm 源换成 npmmirror（Node 依赖用）

注意：UV_PYTHON_INSTALL_DIR 必须用正斜杠 D:/Hermes/pythons。反斜杠会触发 uv 的路径 bug，导致 Python 安装失败并静默回退到系统旧版 Python。

第三步：挂代理，过下载关

安装进行到 Installing dependencies (hash-verified via uv.lock) 这一步时，pm 需要从 github.com releases 下载一批工具二进制（ffmpeg、gh、bws、node 等）。这些没有国内镜像，必须挂代理，否则会报：

network request failed (<urlopen error [WinError 10060] ...)

此时挂上你的代理工具（系统代理模式，或 TUN/全局模式均可），然后重新执行第二步那条命令——已下载的部分会续传，不会从头再来。

代理生效后能看到 github.com 200，安装会一路绿灯直到出现 Setup 向导界面。

第四步：安装向导选项建议

向导问题	建议选择	理由
Setup 方式	选 3. Blank Slate 或直接跳过	Quick Setup 需要 Nous Portal 登录，国内必须挂代理；不登录也能用
Terminal Backend	Local（本机直接运行）	个人自用最省事；需要隔离再换 Docker
消息平台	Skip	需要时再 `hermes setup gateway`
开机自启 gateway	No	不需要常驻就不装服务
遥测	No thanks	隐私友好

看到 ✓ Setup Complete! 即安装成功。

第五步：配置模型（必做）

装完还不能聊天——没配模型。二选一：

方案 A：国内模型 API Key（推荐，无需代理）

hermes model

按提示选服务商（DeepSeek / 通义千问 / GLM / Moonshot 等），填入 API Key。日常聊天、写代码全部走这个，不需要代理。

方案 B：Nous Portal 订阅（需代理）

hermes setup --portal

OAuth 登录 portal.nousresearch.com，一个订阅用 300+ 模型。需要挂代理。

安装产物位置（全 D 盘）

内容	路径
配置 / API Key	`D:\Hermes\hermes\config.yaml`、`D:\Hermes\hermes\.env`
项目源码	`D:\Hermes\hermes-agent`
Python 3.14（pm 托管）	`D:\Hermes\hermes\tools\python-3.14.7-*`
启动命令	`D:\Hermes\hermes\bin`（已自动加入用户 PATH）

安装完成后，新开一个 PowerShell 窗口，直接输入 hermes 即可开始使用。

可选：安装桌面版

CLI 版不满足的话，可以构建桌面 GUI：

$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'; $env:ELECTRON_BUILDER_BINARIES_MIRROR='https://npmmirror.com/mirrors/electron-builder-binaries/'; hermes desktop

两个变量缺一不可：

变量	管什么
`ELECTRON_MIRROR`	Electron 本体 zip（约 138MB）
`ELECTRON_BUILDER_BINARIES_MIRROR`	签名工具、nsis 等辅助二进制

之后想持久化这两个变量（重开窗口不丢）：

[Environment]::SetEnvironmentVariable('ELECTRON_MIRROR','https://npmmirror.com/mirrors/electron/','User'); [Environment]::SetEnvironmentVariable('ELECTRON_BUILDER_BINARIES_MIRROR','https://npmmirror.com/mirrors/electron-builder-binaries/','User')

同理，HERMES_HOME 也建议持久化，保证 hermes 数据永远落 D 盘：

[Environment]::SetEnvironmentVariable('HERMES_HOME','D:\Hermes\hermes','User')

常见问题（FAQ）

Q1：报 Baseline imports failed (dotenv/openai/rich/prompt_toolkit)？
你用的是社区"国内优化版"脚本，它写死了 Python 3.11（Hermes 要求 ≥3.14）。解决：换本文的官方脚本，别改社区脚本。

Q2：报 no version of openai==2.24.0 / exclude-newer 相关错误？
同上，社区脚本把官方的"锁文件安装"换成了"重新解析依赖"，而仓库的 exclude-newer 设置会过滤掉新发布的包。官方脚本无此问题。

Q3：报 WinError 10060 连接超时？
pm 在从 github 拉工具二进制。挂代理（见第三步）。

Q4：报 TypeError: fetch failed 或 Electron 下载卡住？
桌面版打包时 Electron 二进制走 github 超时。设 ELECTRON_MIRROR（见桌面版一节）。

Q5：提示 hermes 命令找不到？
新开一个窗口（PATH 刷新）。或在当前窗口执行 $env:Path = [Environment]::GetEnvironmentVariable('Path','User')。

Q6：以后更新？

hermes update

国内镜像（cnb.cool）与官方 main 同步延迟仅数小时。更新时如再遇 github 下载，同样挂代理即可。

总结

正确路径一句话：官方安装脚本 + 环境变量换源 + pm 下载阶段挂代理。全程只装 D 盘，C 盘无项目文件残留。