一、hermes agent 简介
重磅开源智能体来袭！由 Nous Research 研发打造的 Hermes Agent 已于 2026 年 2 月正式发布，依托 Python 主力开发，合规开放 MIT 开源协议，现已更新至 v0.13.0 全新版本！
告别呆板固定的传统聊天机器人，Hermes Agent 解锁 AI 全新成长形态，主打自主进化、越用越强，全方位满足个人日常办公、企业业务高效运转双重需求。
核心优势
- 任务经验自动归档，形成可持续进化学习体系
- 检索 + 大模型双驱动，实现会话信息持久留存
- 内置多元实用工具，满足多样化实操需求
- 子智能体隔离运行，轻松实现多任务并行
- 全系统兼容适配，单行命令极速安装部署
二、安装前准备
三、安装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 toraw.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 出色的推理能力，轻松解锁全维度办公生产力。这款开源智能体框架自由度极高，可随心定制适配各类场景，更能越用越聪明，不断自我成长进化，成为日常提效、玩转技术的得力搭档。
