Hermes Agent 2026安装教程：全平台一键部署与避坑指南

想快速上手Hermes Agent这个强大的智能体框架？最省心的办法就是直接使用官方提供的一键安装脚本。简单来说，Linux、macOS或WSL2用户用curl命令，Windows用户用PowerShell脚本。对于身处中国大陆的用户，强烈建议优先使用国内镜像源，速度会快很多。安装完成后，通过 hermes setup 命令配置你喜欢的模型和API，就能轻松启动了。

一、准备工作（必看）

在动手之前，花一分钟确认好这几件事，能帮你避开99%的安装问题。

系统要求

• Windows：需要Windows 10（2004版本以上）或Windows 11。长期使用的话，WSL2环境是最稳定、最推荐的选择，当然原生PowerShell也支持。
• Linux：主流的发行版基本都行，比如Ubuntu 20.04、Debian 11、Fedora 36、Arch等。
• macOS：需要macOS 11（Big Sur）或更高版本，Intel和Apple Silicon芯片都支持。
• Android：可以通过Termux应用安装，记得提前在Termux里开启存储权限。

网络与权限

• 网络：如果能访问国际网络，可以直接用官方源。如果下载缓慢或连接不稳定，使用国内镜像源是更明智的选择，速度会有质的提升。
• 权限：在Linux和macOS上运行安装脚本不需要使用sudo，它会自动安装到你的用户目录下。在Windows上，建议以管理员身份运行PowerShell，这样可以避免因路径权限导致的一些小麻烦。

账号准备（可选）

Hermes Agent本身是开源的，但要发挥其智能体的能力，你需要为它配置一个“大脑”——也就是大模型API。以下是针对不同用户群体的推荐：

国内用户大模型推荐：

• Kimi：国内用户的优选。无需特殊网络环境，访问速度快，拥有200万字的超长上下文，还支持文档解析，免费额度也相当充足。
• 智谱AI / z.ai：性价比很高，中文理解和生成能力非常优秀。
• 通义千问：功能全面，与阿里云生态集成好，适合已经是阿里云的用户。

海外用户大模型推荐：

• Nous Portal：官方原生支持，集成度高，体验流畅。
• OpenRouter：模型最全，支持一键切换上百种大模型，灵活性无敌。
• OpenAI：能力全面，生态完善，适合各类通用场景。
• Anthropic：长文本处理的王者，上下文窗口巨大，安全性也高。
• Google Gemini：多模态技术领跑者，全球可用，免费额度友好。
• 本地模型（Ollama/vLLM）：完全保护隐私，无需联网，永久免费。适合对数据安全有极高要求或想离线使用的场景。

二、各平台一键安装（推荐）

对于绝大多数用户，一键安装脚本是最快捷、出错率最低的方式。

1. Linux/macOS/WSL2（最稳定）

打开终端，直接执行以下命令之一：

# 国际官方源（全球通用）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 国内镜像源（中国大陆用户优先，速度更快）
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

这个脚本会自动完成所有工作：安装uv包管理器、Python 3.11、克隆仓库、配置环境变量。安装完成后，记得执行 source ~/.bashrc（如果你用bash）或 source ~/.zshrc（如果你用zsh）来刷新环境变量，这样 hermes 命令才能立刻生效。

2. Windows原生（PowerShell）

以管理员身份打开PowerShell，执行：

# 国际官方源
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

# 国内镜像源（推荐）
irm https://res1.hermesagent.org.cn/install.ps1 | iex

脚本会将Hermes Agent安装到 %LOCALAPPDATA%\hermes 目录，并自动配置好便携版的Git Bash，你不需要额外安装Python。

3. Android（Termux）

首先，从Google Play或F-Droid下载并安装Termux应用。打开Termux后，执行和Linux一样的命令即可：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

脚本会自动适配Termux的环境。安装完成后，直接在Termux里输入 hermes 就能启动。

三、手动安装（适合开发者/高级用户）

如果你喜欢更可控的安装方式，或者打算参与开发，可以按照以下步骤手动安装。

1. 克隆仓库（含子模块）

   git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
   cd hermes-agent
   # 若已克隆但未拉取子模块，执行：
   git submodule update --init --recursive
   

2. 安装uv包管理器

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. 创建并激活虚拟环境

   uv venv
   source .venv/bin/activate # Linux/macOS
   .venv\Scripts\activate # Windows
   

4. 安装依赖并配置

   uv pip install -e .
   hermes setup # 启动交互式配置向导
   

四、配置与启动（关键步骤）

安装完成只是第一步，配置好模型才能让Hermes Agent真正“活”起来。

基础配置

运行以下命令开始配置：

# 方式1：交互式向导（推荐新手）
hermes setup
# 方式2：直接选择模型
hermes model

配置选项：选择模型

接下来，你会面临最重要的选择：为Hermes Agent选择一个“大脑”。

• Kimi：输入你的API密钥即可。这是国内用户的黄金选择，网络稳定，长文本和复杂任务处理能力突出。
• Nous Portal：可以通过OAuth直接登录，对新手非常友好。
• OpenRouter：输入API密钥，然后就可以在它支持的上百个模型中自由切换。
• 本地部署：选择Ollama，体验完全离线的智能体。这需要你先在电脑上安装并运行Ollama服务。

根据提示，输入对应模型的API密钥，并设置好消息通道（如Discord、Telegram等，如果需要）。

本地推理配置（无需API）

如果你想完全离线运行，需要先安装Ollama客户端，并拉取模型：

# 安装Ollama（请先安装Ollama客户端）
ollama pull nous-hermes2
hermes model --local ollama:nous-hermes2

启动Hermes Agent

配置完成后，启动就非常简单了：

# 启动聊天界面
hermes
# 后台运行（Linux/macOS）
hermes start
# 停止后台服务
hermes stop

成功启动后，终端会显示Hermes的欢迎界面，现在你就可以开始和你的智能体对话了。

五、常见问题与解决方法

• 安装失败
  • 网络问题：尝试切换国内镜像源，或者检查你的网络连接是否正常。
  • 权限不足：在Linux/macOS上不要在命令前加sudo。在Windows上，请确保以管理员身份运行PowerShell。
  • 依赖缺失：手动安装git、curl等基础工具。例如在Ubuntu/Debian上可以运行：sudo apt install git curl。
• 命令未找到
  • 安装完成后，记得执行 source ~/.bashrc 或 source ~/.zshrc 来刷新环境变量。
  • Windows用户：可以尝试重启PowerShell，或者手动将 %LOCALAPPDATA%\hermes\bin 添加到系统的PATH环境变量中。
• 模型连接失败
  • 仔细核对输入的API密钥是否正确，并确认该密钥是否有足够的调用额度。
  • 如果使用本地Ollama，请确保Ollama服务已经启动（运行 ollama serve），并且所需的模型已经正确拉取到本地。
• 更新Hermes Agent

  想获取最新功能？一键更新即可：

  hermes update # 一键更新
  # 或者手动更新
  cd ~/.hermes/hermes-agent
  git pull
  git submodule update --init --recursive
  uv pip install -e .
  

六、结语

总的来说，Hermes Agent凭借其极简的部署体验和强大的智能体内核，确实让人眼前一亮。全主流操作系统都能通过一行命令搞定安装，省去了繁琐的环境配置。安装后，跟着内置的交互式向导走一遍，接上大模型，你立刻就拥有了一位具备持续学习能力、能调用各种工具、处理复杂长程任务的智能工作伙伴。

对于国内用户，使用中文社区专属镜像源能大幅提升下载速度和稳定性。Windows用户如果追求最丝滑的体验，优先采用WSL2环境部署会是个好主意。而在大模型的选择上，国内用户搭配Kimi堪称“黄金组合”——无需额外网络配置，对中文语境的理解精准又自然，再加上业界领先的长文本处理能力，无论是代码生成、多工具调用还是复杂任务执行，都能与Hermes Agent的智能体特性深度契合，全方位提升你的工作效率。