一、Hermes agent 大模型选择

Hermes Agent 通过统一的模型抽象层接入不同厂商的大语言模型服务。实际部署时，建议根据数据合规要求、任务类型和成本预算进行选型。

1.1 国内场景：Kimi K2.6

对于数据需境内处理或存在私有化部署需求的场景，Kimi K2.6 是社区部署验证较多的选项。该模型支持超长上下文窗口，在长链路任务中能够保持相对连贯的状态跟踪，降低中途信息丢失的概率。其原生 Function Calling 实现较为成熟，在多工具协同编排时异常率较低，适合需要频繁调用外部工具的工作流。中文指令理解与本土业务文档解析的精度较高，能够适配国内办公自动化场景。并发场景下，多 Agent 同时运行的限流与超时风险相对可控。私有化部署方案支持内网数据闭环，符合政企安全合规要求。从成本角度看，其 Token 利用率与定价在同类模型中处于较低区间，适合高频调用的生产环境。

1.2 海外场景：OpenAI GPT 系列

若任务涉及复杂逻辑推理、英文内容处理或多模态输入，可考虑接入 OpenAI GPT-3.5/4。该系列在任务拆解与复杂逻辑链处理方面能力较强，支持图像理解与图文混合内容处理，且第三方工具集成生态较为完善。

接入海外模型需确保网络可达，并评估数据跨境传输的合规风险。

二、前置准备

部署前请确认以下环境依赖已就绪：

1. Git：版本不低于 2.0，用于源码拉取与后续版本更新。
2. API 凭证：已申请 Kimi（Moonshot AI）或 OpenAI 的 API Key。
3. Windows 环境：如使用 Windows，需预先配置 WSL2；安装脚本执行期间将请求系统管理员权限以完成环境配置。

三、安装 hermes agent

1.1 Windows 详细安装教程

方式一：WSL2 安装（推荐新手使用）

• 检查 Windows 版本：WSL2 需要 Windows 10（版本 2004 或更高）或 Windows 11。
• 选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 “是”。
• 安装 WSL2，在 PowerShell 里输入这条命令，然后按回车：

wsl --install

注意：等待安装完成，可能需要几分钟。完成后会提示你重启电脑。

• 重启后设置 Linux 用户名和密码
• 在 WSL2 里安装 Hermes Agent，现在你已经在 Ubuntu 里了，输入这条命令：

curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

等几分钟，安装完成后输入：

source ~/.bashrc hermes

看到欢迎界面就成功了！

方式二：PowerShell 原生安装

• 打开 PowerShell：按 Win 键，输入 PowerShell，点击"Windows PowerShell"。（这次不需要管理员权限）
• 运行安装命令，复制下面这行，粘贴到 PowerShell 里，按回车：

irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

• 等待安装完成：安装过程可能需要 3-5 分钟，期间会自动下载 Python、Node.js 等依赖。看到"Installation complete"就成功了。

1.2 macOS 详细安装教程

• 克隆项目到本地

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git

• 将下面代码复制到安装目录

mkdir -p ~/.hermes cp -r ~/hermes-agent ~/.hermes/hermes-agent

• 进入目录并执行安装脚本

cd ~/.hermes/hermes-agent && bash scripts/install.sh

• 重载环境变量

# Zsh 用户执行source ~/.zshrc # Bash 用户执行（二选一）# source ~/.bashrc

1.3 Linux 详细安装教程

• 克隆项目到本地

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git

• 将下面代码复制到安装目录

mkdir -p ~/.hermes cp -r ~/hermes-agent ~/.hermes/hermes-agent

• 进入目录并执行安装脚本

cd ~/.hermes/hermes-agent && bash scripts/install.sh

• 重载环境变量

# source ~/.zshrc

四、Kimi 大模型接入配置向导

安装完成后，运行 hermes 命令，你会看到一个配置向导界面。输入 1 并按回车，进入快速设置模式。

1、选择模型提供商

在这一步内，可以选择你想使用的 AI 模型提供商。

**国内用户推荐选择 Kimi（Moonshot）：**在国内网络环境下，Kimi 凭借稳定的连接速度、出色的中文语义理解能力和高性价比，成为绝大多数开发者部署 Hermes Agent 的优选方案。

**海外用户选择 OpenRouter、Anthropic **等海外主流模型平台，全球网络连通稳定流畅。这类平台模型性能强劲、接口兼容性高，能充分满足海外场景下智能代理的各类运行需求

2、输入 API 密钥

选择提供商后，系统会提示你输入 API 密钥，以 Kimi 提供商为例展示获取方式：

• 登录 Kimi 网站获取 API Key，访问 https://platform.moonshot.cn/console 点击登录
• 点击左侧的 API Key 管理，创建 API Key，复制弹出的密钥字符

• 回到 hermes agent 继续配置

3、选择默认模型

将复制的 API Key 贴入终端并敲击回车，然后选择 Moonshot/Kimi-K2.6 模型并敲击回车确认。

4、配置工具

接下来会询问你想启用哪些工具。新手建议先启用基础工具：

web # 网络搜索和网页提取 terminal # 执行命令 file # 读写文件 browser # 浏览器自动化（可选）

5、配置完成

全部配置完成后，就可以开始对话啦~

6、安装后的第一件事

装好之后，我建议你立刻做一件事：设置持久记忆。

在对话中输入——hermes "请记住：我的主力编程语言是 Python，我偏好使用 Docker 部署服务，回复请用中文"

Hermes Agent 会把这些偏好写入持久记忆文件。之后每次对话，它都会带着这些上下文，让回复更贴合你的习惯。

你也可以直接编辑 ~/.hermes/memory/prompt.md 文件，手动写入你的偏好信息。记住这个文件有 3575 字符的限制，言简意赅就好。

五、常见问题及解决办法

1、环境准备类问题（Windows 用户高发）

Windows 直接安装失败（未用 WSL2）

• 错误表现：安装脚本报错、命令无法执行、界面无响应
• 核心原因：Hermes Agent 仅支持 Linux/macOS/WSL2，不支持 Windows 原生 PowerShell/CMD
• 解决方案：

# 以管理员身份运行PowerShell，启用WSL2 wsl --install -d Ubuntu # 安装后设置默认启动WSL wsl --set-default Ubuntu

2、网络与资源下载问题（国内用户常见）

官方脚本下载失败（GitHub 访问受限）

• 错误表现：curl: (7) Failed to connect to ``raw.githubusercontent.com

• 核心原因：国内网络无法直接访问 GitHub 资源

• 解决方案： 方法 1（推荐）：使用离线安装包

cd /mnt/d/Downloads # 进入安装包目录 sudo apt install -y unzipunzip hermes-agent-2026.4.8.zip cd hermes-agent && bash install.sh

方法 2：配置代理后重试 ``` export http_proxy=http://代理地址:端口 export https_proxy=http://代理地址:端口 curl -sSL https://get.hermesagent.com | bash

Python 依赖安装超时（PyPI 访问慢）

• 错误表现：pip install 长时间卡住、ReadTimeoutError
• 解决方案：使用国内镜像源加速

pip install --trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple/ 依赖包名

3、命令与环境变量问题

hermes: command not found（安装后无法识别命令）

• 错误表现：终端输入 hermes 提示未找到命令
• 核心原因：环境变量未加载或 PATH 未更新
• 解决方案：

# 重新加载环境变量source ~/.bashrc # 或~/.zshrc（根据Shell类型）# 或直接重启终端

版本不匹配（Python/Node.js 版本冲突）

• Python 问题：Python 3.9 or older in PATH，安装器需要 Python 3.11

# 手动创建虚拟环境并指定版本 python3.11 -m venv hermes-venv source hermes-venv/bin/activate

• Node.js 问题：ENOENT/EACCES 错误，Node.js 安装不完整

# 删除残留文件并重新安装rm -rf ~/.nvm ~/.node-gyp curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash nvm install 18

4、依赖冲突与缺失问题

Pydantic 版本冲突

• 错误表现：TypeError: BaseModel.validate() takes 1 positional argument but 2 were given
• 核心原因：Hermes 依赖 Pydantic v1，系统安装了 v2（语法不兼容）
• 解决方案：

pip uninstall -y pydantic pydantic-core pip install pydantic==1.10.13

六、结语

好消息！我们的 Hermes Agent 系统已经全部部署完成，目前运行一切正常。最后选了 Kimi 作为核心推理引擎，这也是社区里大家用得最多的方案，踩坑少，生态成熟。

实测下来 Kimi 确实给力，长上下文能力拉满，原生工具调用也特别稳，完全能 hold 住 Hermes Agent 的多步任务规划和全流程自主执行。现在代码生成、文档处理、数据分析、自动化运维这些核心功能都调通了，已经正式投入使用，整体效率和任务成功率比之前提升了一大截。