本文将以保姆级步骤完整记录 Hermes Agent 的全流程部署过程，从最基础的环境校验、一键脚本安装，到核心模型接入与网关服务配置，逐一拆解每个关键节点的操作要点与注意事项。通过本文你将避开绝大多数新手容易踩的配置坑，快速上手并拥有一套能够持续自我成长的 AI 智能体系统。
一、hermes agent 简介
Nous Research 在 2026 年 2 月正式推出了 Hermes Agent，这是一款采用 MIT 开源许可协议的自主进化型 AI 智能体框架，核心代码基于 Python 开发，截至目前已迭代至 v0.13.0 版本。与传统的对话式聊天机器人有着本质区别，Hermes Agent 能够在执行各类任务的过程中自动提炼并沉淀可复用的技能，从而实现真正意义上的自我迭代与能力提升，运行时间越长、处理任务越多，其综合表现就越出色。此外，该框架还内置了持久化记忆系统、原生多工具调用能力以及高效的并行任务处理引擎，同时具备出色的跨平台兼容性和简单易用的安装流程，能够为个人用户和企业级场景提供新一代的智能 AI 助手解决方案。
二、安装前准备
一、系统要求
- Windows：Win10 2004+/Win11，必须通过 WSL2 运行（不支持 WSL1）
- macOS：12 Monterey 及以上，完美支持 Intel/Apple Silicon 全系列芯片
- Linux：Ubuntu 20.04+/Debian 11+/CentOS 8+/Fedora 36 + 等主流发行版
二、硬件要求
基础运行
- 最低配置：x86_64/ARM64 CPU、256MB 内存、100MB 存储、稳定网络
- 推荐配置：2 核 CPU、2GB 内存、1GB 存储、10Mbps 以上网络
三、核心前置准备
- API 密钥：提前获取至少一个主流模型密钥（推荐国内外：Kimi、Anthropic等等）
- 网络要求：能访问 GitHub 和 PyPI，国内用户建议配置清华 PyPI 镜像
- 权限要求：Linux/WSL2 用户需拥有 sudo 权限，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
四、向导配置教程
安装完成后，运行hermes命令，你会看到一个配置向导界面。输入1并按回车，进入快速设置模式。
1、选择模型提供商
在这一步内，可以选择你想使用的 AI 模型提供商。
新手推荐：
- 国内用户：选Kimi，适合国内用户，网络也稳定
- 想尝试多种模型：选OpenRouter，一个 API Key 能用 Claude、GPT、Qwen 等多种模型
- Claude 爱好者：选Anthropic，直接用 Claude 官方 API
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、配置完成
全部配置完成后，就可以开始对话啦~
五、结语
部署成功！你的专属自主进化 AI 智能体已上线。
Hermes Agent 全链路本地化部署流程已全部执行完毕，系统自检通过，所有核心组件运行正常，服务已全面就绪。
由 Nous Research 倾力打造的这款智能体框架，采用了先进的任务驱动式进化机制。它不仅具备高度的可定制性与场景适配能力，更能在与你的每一次交互、每一个任务执行过程中，自主沉淀知识、优化技能树，构建出独一无二的个性化能力模型。
现在，开启你的私有化智能体探索之旅吧。充分释放其自主学习与多工具协同的强大潜能，重塑你的工作流，突破效率边界，在人工智能的前沿领域开拓属于自己的天地。
