一、hermes agent 简介

重磅开源智能体来袭！由 Nous Research 研发打造的 Hermes Agent 已于 2026 年 2 月正式发布，依托 Python 主力开发，合规开放 MIT 开源协议，现已更新至 v0.13.0 全新版本！

告别呆板固定的传统聊天机器人，Hermes Agent 解锁 AI 全新成长形态，主打自主进化、越用越强，全方位满足个人日常办公、企业业务高效运转双重需求。

核心优势

1. 任务经验自动归档，形成可持续进化学习体系
   
2. 检索 + 大模型双驱动，实现会话信息持久留存
   
3. 内置多元实用工具，满足多样化实操需求
   
4. 子智能体隔离运行，轻松实现多任务并行
   
5. 全系统兼容适配，单行命令极速安装部署
   

二、安装前准备

三、安装hermes agent

新手专属保姆级安装教程，适配 Windows、macOS、Linux、Docker 全平台，按步骤操作，几分钟快速完成部署启动。

第一步：home目录中创建.hermes文件夹

mkdir ~/.hermes

第二步：使用国内镜像仓库clone代码

第三步：设置uv阿里云地址

export UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple"

第四步：设置npm镜像

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

第五步：设置playwright镜像

export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

第六步：执行一键脚本

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

第七步：快速设置

第八步：选择模型提供商

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

新手推荐：

• 国内用户：国内网络环境下，Kimi作为优选大模型提供商——连接稳定、处理速度快、性价比突出
  

第九步：输入 API 密钥

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

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

• 回到hermes agent继续配置
  

第十步：选择默认模型

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

第十一步，跳过聊天平台设置

第十二步：全部流程完成后，就可以开始对话啦~

四、常见问题及解决办法

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 私有 AI 助手就搭建完毕啦！系统运行稳定流畅，借助 Kimi 出色的推理能力，轻松解锁全维度办公生产力。这款开源智能体框架自由度极高，可随心定制适配各类场景，更能越用越聪明，不断自我成长进化，成为日常提效、玩转技术的得力搭档。