Qwen Studio下面是一份 **菜鸟从 0 开始版** 的 Hermes Agent Windows 安装指引。适合全新机器、Windows 10/11、中国大陆网络、目标是在 PowerShell 里正常使用 hermes。你可以自己按步骤做也可以把整份内容发给 Qwen3.8 / ChatGPT / Claude让它一步一步带你。---# 菜鸟从 0 开始安装 Hermes Agent## 目标安装完成后在 PowerShell 里执行powershellhermes --version能看到类似textHermes Agent v0.19.0然后执行powershellhermes可以进入聊天界面并且模型能回复。---# 给 AI 网页端的一步一步带练提示词如果你想让 AI 带你先发这段text我是 Windows 菜鸟请从 0 开始一步一步带我在 Windows PowerShell 里安装 Hermes Agent。规则1. 每次只给我一个步骤。2. 每次只给少量命令。3. 等我复制 PowerShell 输出给你之后你再给下一步。4. 如果报错先分析我的输出再给最少修复命令。5. 如果某一步可能卡住提前告诉我多久算异常。6. 我在中国大陆网络环境需要考虑 GitHub、pip、npm 下载问题。7. 我的最终目标是 PowerShell 里可以正常运行 hermes。8. 请使用下面的“菜鸟从 0 开始安装指引”作为流程。请从 Step 1 开始。然后把下面整份指引贴给它。---# Step 1打开 PowerShell按textWin X然后选择textWindows Terminal或者textWindows PowerShell如果你看到的是蓝色或黑色命令行窗口并且提示符类似textPS C:\Users\你的用户名就说明可以开始了。---# Step 2检查 winget 是否可用执行powershellwinget --version如果看到类似textv1.8.1911或者更高版本说明可用。如果提示text无法将“winget”项识别为 cmdlet、函数、脚本文件或可运行程序的名称说明没有 winget。解决办法1. 打开 Microsoft Store。2. 搜索textApp Installer或者中文text应用安装程序3. 安装或更新它。4. 重新打开 PowerShell再次执行powershellwinget --version---# Step 3安装 Python 3.11Hermes 通常需要 Python 3.11。如果你电脑只有 Python 3.12也可能不够建议单独安装 Python 3.11。执行powershellwinget install -e --id Python.Python.3.11 --source winget --accept-package-agreements --accept-source-agreements如果弹出 UAC 权限确认点text是安装完成后关闭当前 PowerShell重新打开一个新的 PowerShell。---# Step 4检查 Python 3.11执行powershellpy -0ppy -3.11 --versionpy -3.11 -m pip --version期望看到类似text-3.11-64 C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\python.exePython 3.11.9pip 24.0 ...如果看到textPython 3.11 not found!说明 Python 3.11 没装好需要重新执行 Step 3。---# Step 5安装 Git执行powershellwinget install -e --id Git.Git --source winget --accept-package-agreements --accept-source-agreements安装完成后关闭 PowerShell重新打开。检查powershellgit --version期望看到类似textgit version 2.55.0.windows.2---# Step 6安装 Node.js建议安装 LTS 版本powershellwinget install -e --id OpenJS.NodeJS.LTS --source winget --accept-package-agreements --accept-source-agreements安装完成后关闭 PowerShell重新打开。检查powershellnode --versionnpm --version期望看到类似textv22.xx.x10.x.x或者更高版本。---# Step 7安装 ripgrep 和 ffmpeg这两个不是每次都必须但 Hermes 安装过程会检查它们。提前装好可以减少失败。安装 ripgreppowershellwinget install -e --id BurntSushi.ripgrep.MSVC --source winget --accept-package-agreements --accept-source-agreements安装 ffmpegpowershellwinget install -e --id Gyan.FFmpeg --source winget --accept-package-agreements --accept-source-agreements安装完成后关闭 PowerShell重新打开。检查powershellrg --versionffmpeg -version如果能看到版本号说明正常。如果 ffmpeg -version 找不到命令可以先继续后面 Hermes 安装器如果报错再处理。---# Step 8配置 pip 国内源执行powershellpy -3.11 -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple检查powershellpy -3.11 -m pip config get global.index-url期望输出texthttps://pypi.tuna.tsinghua.edu.cn/simple---# Step 9配置 npm 国内源执行powershellnpm config set registry https://registry.npmmirror.com检查powershellnpm config get registry期望输出texthttps://registry.npmmirror.com---# Step 10安装 uvHermes 安装过程会使用 uv。为了避免安装器卡住我们先手动安装。执行powershellpy -3.11 -m pip install -U uv安装完成后检查powershellpy -3.11 -m uv --version或者用完整路径检查。更稳的方式是下面 Step 11。---# Step 11把 uv.exe 复制到 Hermes 的 bin 目录执行这一段powershell$scripts (py -3.11 -c import sysconfig; print(sysconfig.get_path(scripts))).Trim()$uvExe Join-Path $scripts uv.exeWrite-Output uv.exe path: $uvExeTest-Path $uvExeNew-Item -ItemType Directory -Force -Path $env:LOCALAPPDATA\hermes\bin | Out-NullCopy-Item $uvExe $env:LOCALAPPDATA\hermes\bin\uv.exe -Force验证powershell $env:LOCALAPPDATA\hermes\bin\uv.exe --version期望看到类似textuv 0.12.0---# Step 12检查有没有旧的坏 Git 镜像规则有些机器以前配置过清华 GitHub 镜像但现在可能不可用。执行powershellgit config --global --list --show-origin | Select-String insteadof|url|proxy|mirror|tuna|githubgit config --system --list --show-origin | Select-String insteadof|url|proxy|mirror|tuna|github如果看到类似texturl.https://mirrors.tuna.tsinghua.edu.cn/github-git/.insteadofgitgithub.com:执行删除powershellgit config --global --unset url.https://mirrors.tuna.tsinghua.edu.cn/github-git/.insteadof再次检查powershellgit config --global --list --show-origin | Select-String insteadof|tuna如果没有输出说明清理干净。---# Step 13测试 GitHub 是否可以直连执行powershellgit ls-remote --heads https://github.com/NousResearch/hermes-agent.git main如果成功会看到类似text0f64557c06f3e878fd9ec5170b9bca7f20e2778e refs/heads/main如果失败例如textRecv failure: Connection was reset或者textFailed to connect to github.com:443请继续 Step 14。如果成功可以跳到 Step 16。---# Step 14测试 GitHub 镜像是否可用执行powershellgit ls-remote --heads https://ghfast.top/https://github.com/NousResearch/hermes-agent.git main如果成功会看到类似text0f64557c06f3e878fd9ec5170b9bca7f20e2778e refs/heads/main如果失败或卡住按 Ctrl C尝试另一个镜像powershellgit ls-remote --heads https://gh-proxy.com/https://github.com/NousResearch/hermes-agent.git main或者powershellgit ls-remote --heads https://gitclone.com/github.com/NousResearch/hermes-agent.git main只要有一个能返回 commit hash就可以继续。下面以 ghfast.top 为例。---# Step 15配置 GitHub 镜像重写如果你使用 ghfast.top执行powershellgit config --global url.https://ghfast.top/https://github.com/.insteadof https://github.com/git config --global --add url.https://ghfast.top/https://github.com/.insteadof gitgithub.com:git config --global --add url.https://ghfast.top/https://github.com/.insteadof ssh://gitgithub.com/再设置 SSH 快速失败避免 SSH 卡住powershellgit config --global core.sshCommand ssh -o ConnectTimeout5 -o BatchModeyes检查powershellgit config --global --get-all url.https://ghfast.top/https://github.com/.insteadofgit config --global core.sshCommand测试powershellgit ls-remote --heads https://github.com/NousResearch/hermes-agent.git maingit ls-remote --heads gitgithub.com:NousResearch/hermes-agent.git main如果两条都能返回 commit hash说明镜像配置成功。注意这个配置会让所有 GitHub 仓库走 ghfast 镜像。以后如果想取消可以执行powershellgit config --global --unset-all url.https://ghfast.top/https://github.com/.insteadofgit config --global --unset core.sshCommand---# Step 16下载 Hermes 官方安装脚本执行powershell[Net.ServicePointManager]::SecurityProtocol [Net.SecurityProtocolType]::Tls12$installer $env:TEMP\hermes-install.ps1Invoke-WebRequest -Uri https://hermes-agent.nousresearch.com/install.ps1 -OutFile $installerTest-Path $installer期望输出textTrue如果下载失败例如text无法连接到远程服务器说明官方安装脚本下载也受网络影响。这时可以先找可用代理或者让 AI 帮你分析具体报错。---# Step 17运行 Hermes 安装脚本执行powershell$env:GIT_TERMINAL_PROMPT 0powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\hermes-install.ps1这个过程可能比较久。正常会看到类似阶段textInstalling uv package managerVerifying Python 3.11Checking GitDetecting Node.jsInstalling ripgrep and ffmpegCloning Hermes repositoryCreating Python virtual environmentInstalling Python dependenciesInstalling Node.js dependenciesAdding Hermes to PATHWriting configuration templatesMarking install complete如果你只想用 PowerShell CLI不需要桌面端就不要加桌面构建参数。如果安装脚本进入设置向导继续 Step 18。---# Step 18安装向导选择 Blank Slate如果看到textHow would you like to set up Hermes?1. Quick Setup (Nous Portal)2. Full setup3. Blank Slate建议选择text3也就是textBlank Slate原因textQuick Setup 可能需要 OAuth 登录境外服务。Full setup 配置项太多。Blank Slate 最干净先让 hermes 可用后面再配置模型。---# Step 19选择模型提供方如果看到 Provider 列表例如text1. Nous Portal2. Fireworks AI3. OpenRouter...18. DeepSeek...如果你有 DeepSeek API Key选择text18如果你使用通义千问 / DashScope可以选择text9. Qwen或者选择text33. Custom endpoint下面以 DeepSeek 为例。---# Step 20配置 DeepSeek当向导问你 API Key 时输入你的 DeepSeek API Key。如果问 Base URL / Endpoint填texthttps://api.deepseek.com/v1如果问模型推荐textdeepseek-chat说明textdeepseek-chat 更适合普通对话和 agent tool use。deepseek-reasoner 更偏推理可以后续再配置。如果问 auxiliary models可以先选textLeave unchanged或者跳过。---# Step 21等待安装完成如果最后看到textInstallation Complete!说明主体安装完成。它可能会提示textRestart your terminal for PATH changes to take effect请关闭当前 PowerShell重新打开一个新的 PowerShell。---# Step 22检查 hermes 命令在新的 PowerShell 里执行powershellwhere.exe hermeshermes --version正确结果应该类似textC:\Users\你的用户名\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes.exe以及textHermes Agent v0.19.0如果 where.exe hermes 显示的是textC:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\hermes.exe说明你有另一个同名 hermes 命令冲突。继续 Step 23。如果没有冲突可以跳到 Step 25。---# Step 23检查旧的 hermes 是什么执行powershellGet-ChildItem C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\hermes* | Select-Object Namepy -3.12 -m pip show hermes如果看到类似textName: hermesVersion: 0.9.1Summary: Workflow to publish research software with rich metadata那它不是 Hermes Agent而是另一个 Python 工具。---# Step 24重命名冲突的 hermes.exe如果你不需要那个研究软件发布工具可以重命名它powershell$oldHermes C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\hermes.exeif (Test-Path $oldHermes) {Rename-Item $oldHermes hermes.research-tool.exe -Force}确认powershellGet-ChildItem C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\hermes* | Select-Object Name应该看到类似texthermes-marketplace.exehermes.research-tool.exe如果以后想恢复powershellRename-Item C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\hermes.research-tool.exe hermes.exe -Force---# Step 25确认 PATH 里有真正的 Hermes执行powershell([Environment]::GetEnvironmentVariable(Path, User) -split ;) | Select-String hermes-agent\\venv\\Scripts期望看到textC:\Users\你的用户名\AppData\Local\hermes\hermes-agent\venv\Scripts如果没有执行powershell$realScripts $env:LOCALAPPDATA\hermes\hermes-agent\venv\Scripts[Environment]::SetEnvironmentVariable(Path,$realScripts; [Environment]::GetEnvironmentVariable(Path, User),User)然后关闭 PowerShell重新打开。---# Step 26最终验证执行powershellwhere.exe hermeshermes --version期望textC:\Users\你的用户名\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes.exeHermes Agent v0.19.0然后执行powershellhermes config查看配置。再执行powershellhermes doctor检查常见问题。如果 doctor 没有致命错误执行powershellhermes进入聊天界面后输入text你好如果模型能回复说明安装成功。退出聊天界面可以用textCtrl C或者输入text/exit---# 常见坑速查---## 坑 1Python 3.11 not found现象textPython 3.11 not found!解决powershellwinget install -e --id Python.Python.3.11 --source winget --accept-package-agreements --accept-source-agreements然后重开 PowerShellpowershellpy -3.11 --version---## 坑 2卡在 Installing managed uv现象textInstalling managed uv into C:\Users\...\AppData\Local\hermes\bin解决powershellpy -3.11 -m pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simplepy -3.11 -m pip install -U uv然后复制powershell$scripts (py -3.11 -c import sysconfig; print(sysconfig.get_path(scripts))).Trim()New-Item -ItemType Directory -Force -Path $env:LOCALAPPDATA\hermes\bin | Out-NullCopy-Item (Join-Path $scripts uv.exe) $env:LOCALAPPDATA\hermes\bin\uv.exe -Force $env:LOCALAPPDATA\hermes\bin\uv.exe --version---## 坑 3GitHub clone 失败现象textFailed to connect to github.com:443或者textRecv failure: Connection was reset解决powershellgit ls-remote --heads https://ghfast.top/https://github.com/NousResearch/hermes-agent.git main如果成功设置powershellgit config --global url.https://ghfast.top/https://github.com/.insteadof https://github.com/git config --global --add url.https://ghfast.top/https://github.com/.insteadof gitgithub.com:git config --global --add url.https://ghfast.top/https://github.com/.insteadof ssh://gitgithub.com/git config --global core.sshCommand ssh -o ConnectTimeout5 -o BatchModeyes---## 坑 4清华 GitHub 镜像导致 not found现象textfatal: repository https://mirrors.tuna.tsinghua.edu.cn/github-git/NousResearch/hermes-agent.git/ not found解决powershellgit config --global --unset url.https://mirrors.tuna.tsinghua.edu.cn/github-git/.insteadof检查powershellgit config --global --list --show-origin | Select-String insteadof|tuna---## 坑 5hermes --version 出来奇怪子命令现象textusage: hermes [-h] {help,version,init,clean,harvest,process,curate,deposit,postprocess} ...这说明你调到了另一个 Python 包 hermes。检查powershellwhere.exe hermespy -3.12 -m pip show hermes如果确认不是 Hermes Agent重命名powershellRename-Item C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\hermes.exe hermes.research-tool.exe -Force然后重开 PowerShell。---## 坑 6PATH 没生效现象text安装完成但 hermes 还是错的。检查powershell([Environment]::GetEnvironmentVariable(Path, User) -split ;) | Select-String hermes-agent\\venv\\Scripts如果没有加入powershell$realScripts $env:LOCALAPPDATA\hermes\hermes-agent\venv\Scripts[Environment]::SetEnvironmentVariable(Path,$realScripts; [Environment]::GetEnvironmentVariable(Path, User),User)然后关闭 PowerShell重新打开。---# 成功标志最终只要满足这三条就算成功powershellwhere.exe hermes第一行是textC:\Users\你的用户名\AppData\Local\hermes\hermes-agent\venv\Scripts\hermes.exe然后powershellhermes --version显示textHermes Agent v0.19.0最后powershellhermes可以进入聊天并且模型能回复。---# 后续常用命令重新配置模型powershellhermes setup model查看配置powershellhermes config编辑配置powershellhermes config edit检查问题powershellhermes doctor启动聊天powershellhermes启动消息网关powershellhermes gateway更新 Hermespowershellhermes update---# 配置文件位置主配置textC:\Users\你的用户名\AppData\Local\hermes\config.yamlAPI Key / 环境变量textC:\Users\你的用户名\AppData\Local\hermes\.env代码目录textC:\Users\你的用户名\AppData\Local\hermes\hermes-agent日志目录textC:\Users\你的用户名\AppData\Local\hermes\logs