跳到主要内容

Hermes Agent 下载与使用手册

本手册介绍基本使用方法。安装命令和功能会随版本更新，请以 Hermes Agent 官方文档 和 Hermes Agent Github官方文档 为准。

教程基于 Hermes Agent 官方文档 和 Hermes Agent Github官方文档 编写。

一、下载前了解​

  • Hermes Agent 是 Nous Research 提供的 AI 辅助工具。它可以连接不同厂商或中转站提供的模型。

  • Hermes 有多种下载方式，这里介绍 CLI 版本。桌面版和 CLI 使用同一套配置、会话和 API Key，若安装了 CLI 和桌面版，在其中一个里面改过的设置，另一个也能用。

  • Hermes的前置条件较多，但不需手动安装 Python、Node.js、ripgrep 或 ffmpeg。安装程序会检测缺失的依赖并自动安装。只需确保 git 可用即可。

    • uv（快速 Python 包管理器）
    • Python 3.11（通过 uv，无需 sudo）
    • Node.js v22（用于浏览器自动化和 WhatsApp 桥接）
    • ripgrep（快速文件搜索）
    • ffmpeg（TTS 的音频格式转换）

  • 若电脑已下载 Git ，则Hermes将使用现有 Git ；若还未安装，安装 Hermes 时安装程序会下载便携式 PortableGit

二、Hermes CLI 版本安装​

系统要求：

  • Windows 10 或 Windows 11

官方同时支持 Windows 本机安装和 WSL2。这里介绍 Windows 本机安装方式。若使用 WSL2，请按 Linux 标签页中的命令安装。

1、安装 Git​

请访问 Git - Downloads 网站，选择 Windows 对应版本安装。

若尚未安装 Git，官方安装器也可以自动安装一份便携版 Git，不会改动系统里已有的 Git。

2、安装 Hermes​

Win + R 输入 “powershell” 打开终端窗口并运行：

这条命令需要在 PowerShell 中运行，不要在 CMD 中运行。

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装后重新打开终端，在 CC Switch 中进行配置。如何配置请看 CC Switch 配置

3、启动 Hermes​

打开终端并运行：

#如果想在特定目录里运行 Hermes ，在启动 Hermes 前可以运行

# CMD 终端窗口
cd /d "你的工作目录具体路径地址"

# PowerShell 终端窗口
cd 你的工作目录具体路径地址

#如果想在启动前检查一下，可以运行
hermes doctor

#启动
hermes

#打开最近一次对话
hermes --continue

#查看历史对话列表
hermes sessions list

#或打开指定历史对话
hermes --resume 会话ID

三、Hermes 桌面版安装​

桌面版是原生图形界面，支持 macOS、Windows 和 Linux。第一次打开时，它会把 Hermes 运行环境装到本机（macOS / Linux 为 ~/.hermes，Windows 为 %LOCALAPPDATA%\hermes），目录和 CLI 安装相同。

如果使用桌面版，配置可以在桌面版里面进行配置，可以不是用CC Switch。

桌面版的教学网络上比较多，可以对照着B站教学来，这里推荐一位up主的 视频 。

系统要求：

  • Windows 10 或 Windows 11

1、下载并安装​

打开 Hermes Desktop 官方下载页，下载 Windows 对应安装包并运行。

如果已经按上一节装好了 CLI，也可以打开 PowerShell，运行：

hermes desktop

2、配置并启动​

安装后重新打开桌面版，在 CC Switch 中进行配置。如何配置请看 CC Switch 配置

配置完成后关闭桌面版和终端，再重新打开 Hermes Desktop。也可以在终端中运行 hermes desktop 启动。

四、安全注意事项​

  • 不要把 API Key 写进公开代码仓库或截图。
  • AI 生成的命令可能删除、覆盖或上传文件，执行前先阅读命令内容。
  • 不要在包含密码、个人资料或公司机密的目录中盲目授权 AI 操作。