hermes-agent

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Windows 系统（安装路径为 %LOCALAPPDATA%\hermes）
• PowerShell 环境（校验步骤均为 PowerShell 脚本）
• 可访问 GitHub Releases 下载 uv 压缩包
• 可选：GitHub CLI，用于校验下载文件来源
• 一个可用的 LLM 服务商与模型（通过 hermes model 选择）

安装与启动步骤

1. 1安装 GitHub CLI

   若本机没有 gh 命令，先用 winget 安装 GitHub CLI，后续校验 uv 压缩包来源时需要用到。

   winget install --id GitHub.cli

   复制

2. 2读取本机 uv 版本

   从 Hermes 自带的 uv 读取版本号并存入 $ver 变量，供下一步拼接下载地址使用，需在同一窗口继续执行。

   $uv = "$env:LOCALAPPDATA\hermes\bin\uv.exe"
   $ver = (& $uv --version).Split(' ')[1]

   复制

3. 3下载 uv 压缩包

   强制使用 TLS1.2，并按上一步得到的 $ver 从 astral-sh/uv 官方 Release 下载 Windows x64 压缩包到临时目录。

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   $zip = "$env:TEMP\uv.zip"
   Invoke-WebRequest "https://github.com/astral-sh/uv/releases/download/$ver/uv-x86_64-pc-windows-msvc.zip" -OutFile $zip -UseBasicParsing

   复制

4. 4校验来源与哈希

   用 gh attestation 确认压缩包来自官方仓库并解压，再比对解压出的 uv.exe 与本地 uv.exe 哈希是否一致。

   gh attestation verify $zip --repo astral-sh/uv
   Expand-Archive $zip "$env:TEMP\uv_x" -Force
   (Get-FileHash "$env:TEMP\uv_x\uv.exe").Hash -eq (Get-FileHash $uv).Hash

   复制

5. 5加入杀软白名单

   Windows Defender 用户以管理员身份运行 PowerShell 后执行；Bitdefender 需在控制台 Protection > Antivirus > Settings > Manage Excepti

   Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"

   复制

6. 6运行安装向导

   执行 hermes setup 一次性完成全部配置；若只需改单项，也可用 hermes config set 与 hermes config get。

   hermes setup

   复制

7. 7选择模型与工具

   用 hermes model 选择 LLM 服务商和模型，用 hermes tools 配置启用哪些工具。

   hermes model
   hermes tools

   复制

8. 8启动交互对话

   直接运行 hermes 进入交互式 CLI 开始对话；后续可用 hermes update 更新、hermes doctor 诊断问题。

   hermes

   复制

如何确认成功

校验时先看 gh attestation 输出 “Verification succeeded”，且哈希比对行打印 True；安装后运行 hermes doctor 无报错、执行 hermes 能进入交互界面即成功。

常见问题

注意事项

• README 节选未给出 hermes 本体的安装命令，本教程步骤依据其 Quick Install 与 Getting Started 小节整理，实际安装请以官网文档为准。
• 校验相关命令均为 PowerShell 脚本，请在 PowerShell 中执行，且 $ver、$zip、$uv 变量需在同一会话中依次执行才能生效。
• Windows Defender 需以管理员身份运行 PowerShell 才能执行 Add-MpPreference。
• 误报问题可参考上游报告 astral-sh/uv#13553、#15011、#10079，完整文档见 https://hermes-agent.nousresearch.com/docs/。