全网最详细！Hermes Agent 从 0 到 1 保姆级部署教程来了！从环境检查到一键安装，从模型接入到网关配置，每一步都有截图和详细说明，新手也能零失败。跟着做，你就能拥有一个完全属于自己、会自己学习成长的 AI 智能体，彻底告别千篇一律的通用聊天机器人！

一、为什么 hermes agent 值得你花时间部署？

Nous Research 在 2026 年 2 月放大招，开源了这款革命性的自主进化 AI 智能体框架 ——Hermes Agent。它采用 MIT 协议完全免费，核心用 Python 开发，目前已经迭代到 v0.13.0 版本。
这不是一个只会聊天的 AI，而是一个能真正自我成长的智能助手。它会在帮你干活的过程中自动学习，总结方法，沉淀技能，运行时间越长，能力就越强。再加上持久化记忆、原生多工具集成、并行任务处理这些黑科技，以及简单的安装流程和跨平台支持，它绝对是目前最值得个人和企业入手的新一代 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、配置完成

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

五、结语

太棒了！你的 Hermes Agent 全链路本地化部署已经顺利完成啦！
从这一刻起，你就拥有了一个完全属于自己的私有化 AI 智能体。它现在运行得非常稳定，所有功能都已经准备妥当，正迫不及待地想要为你服务。
这可不是一个普通的 AI 助手哦。作为 Nous Research 精心打造的作品，它不仅能根据你的需求进行深度定制，适配各种使用场景，更厉害的是它会自己学习成长 —— 你用得越多，它就越了解你，处理事情也会越来越得心应手。
愿你在和这个专属 AI 伙伴的相处中，尽情发挥它自主学习和多工具调用的本领，让它帮你把工作变得更轻松高效，一起去探索更多有趣的可能性！