Hermes Agent 2026年6月最新安装教程

Hermes Agent 是 Nous Research 开发的自进化开源 AI 智能体框架,彻底解决了传统 AI Agent 部署门槛高、依赖复杂的痛点------全程仅需几行命令即可完成部署,最低仅需 256MB 内存就能稳定运行。它突破了普通聊天 AI"只说不做"的局限,具备跨会话持久记忆、自动生成程序化技能、多工具集成和跨平台交互能力,能真正成为可执行实际任务的"数字分身"。

本文融合多版本官方教程的核心优势,覆盖全系统部署方案,帮助你轻松搭建好专属智能体。

一、前置环境准备

1.1 系统与硬件要求

Hermes Agent 支持多平台运行,不同场景的配置要求如下:

类别 详细要求
支持系统 Linux(Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / Arch) macOS 12+(Intel/Apple Silicon 全兼容) Windows WSL2(推荐 Windows 用户首选) Windows 原生(Early Beta,功能受限) Android(Termux 环境)
最低硬件 CPU:x86_64/ARM64;内存:256MB;存储:100MB
推荐硬件 4 核 CPU + 8GB 内存(流畅运行复杂任务与多工具调用)
网络要求 稳定联网,能访问所选 LLM API 提供商;安装过程需访问 PyPI/GitHub

1.2 前置依赖安装

官方安装脚本会自动处理 Python 3.11、Node.js v22、uv 等核心依赖,仅需提前安装 Git 即可:

  • Linux(Ubuntu/Debian)
复制代码
    sudo apt update && sudo apt upgrade -y
    sudo apt install git curl -y
    git --version  # 验证安装
    ```

- **macOS**

    

```Bash
    # 未安装 Homebrew 先执行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    brew install git
    git --version
    ```

- **WSL2**:进入 Ubuntu 终端后,执行上述 Linux 命令即可。

### 1.3 国内用户必做:网络加速配置

国内环境访问 GitHub、PyPI 速度较慢,提前配置以下镜像可避免安装失败:

```Bash
# Git 全局镜像加速
git config --global url."https://mirror.ghproxy.com/https://github.com".insteadOf "https://github.com"

# pip 阿里云镜像
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com

# npm 腾讯云镜像
npm config set registry https://mirrors.cloud.tencent.com/npm/ --global

二、全平台安装方式(按需选择)

2.1 一键安装脚本(新手首选,最快 2 分钟完成)

这是最稳定、最简单的安装方式,自动完成环境创建、依赖安装和命令配置:

  • 国内用户(优先使用,速度最快)
复制代码
    curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
    ```

- **海外用户**

    

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

安装完成后刷新环境变量:

```Bash
# Bash 用户
source ~/.bashrc
# Zsh 用户(macOS 默认)
source ~/.zshrc

验证安装:终端输入 hermes --version,显示版本号即表示成功。

2.2 Docker 部署(推荐生产环境)

环境隔离性好,避免与系统其他服务冲突,适合长期后台运行:

复制代码
# 安装 Docker(Ubuntu)
sudo apt install docker.io -y
sudo systemctl start docker
sudo systemctl enable docker

# 拉取官方最新镜像
docker pull nousresearch/hermes-agent:latest

# 创建本地配置目录(持久化数据)
mkdir -p ~/.hermes/docker-config

# 启动容器(后台运行,映射 8080 端口)
docker run -d \
  --name hermes-agent \
  -v ~/.hermes/docker-config:/root/.hermes \
  -p 8080:8080 \
  nousresearch/hermes-agent:latest

# 查看运行状态
docker ps | grep hermes-agent

2.3 pip 快速安装

适合习惯用 Python 包管理工具的用户,推荐使用 pipx 获得更好的隔离性:

复制代码
# 普通 pip 安装
pip install hermes-agent

# pipx 安装(推荐,隔离系统环境)
pipx install hermes-agent

# 补全可选依赖(如浏览器自动化、视频处理)
hermes postinstall

2.4 源码手动安装(开发者首选)

适合需要修改源码、贡献代码或体验最新功能的用户:

复制代码
# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 创建并激活虚拟环境
python3.11 -m venv venv
source venv/bin/activate  # Linux/macOS/WSL2
# venv\Scripts\activate     # Windows

# 安装所有依赖
pip install --upgrade pip
pip install -e ".[all]"

# 创建全局软链接(可选)
mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

2.5 其他平台安装

  • Windows 原生(Beta):打开 PowerShell 7+(管理员模式)执行
复制代码
    iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
    ```

- **Android(Termux)**

    

```Bash
    pkg update && pkg upgrade -y
    pkg install git python nodejs ripgrep ffmpeg build-essential
    git clone https://github.com/NousResearch/hermes-agent.git
    cd hermes-agent
    python -m venv venv
    source venv/bin/activate
    pip install -e ".[all]"
    ```

## 三、核心配置:Kimi 大模型——国内用户最优选择

安装完成后必须配置 LLM 模型才能正常使用。对于国内用户,Kimi 大模型是 Hermes Agent 的优选搭档,在工具调用、长文本处理、中文理解、性价比和网络稳定性等核心维度均表现突出:

### 3.1 为什么 Kimi 是国内用户优选?

- **工具调用能力**:K2.6 版本工具调用准确率达 96%,支持 4000+ 步连续调用和单轮 128 个工具定义,完美适配 Hermes 的多工具生态

- **任务规划能力**:支持 300 个子智能体并行,可连续运行 12-13 小时完成完整工程流程,具备错误重试和经验总结能力

- **长上下文处理**:提供 256K API 上下文窗口,支持 200 万字无损解析,能高效读取 Hermes 的跨会话记忆文件

- **输出稳定性**:可验证任务失败率低于 2%,稳定输出 JSON 格式工具调用指令,代码编译成功率高

- **性价比**:API 价格亲民,免费额度充足,缓存命中时输入成本进一步降低,无最低消费限制

- **网络与隐私**:国内直连无需代理,云端 API 承诺不将用户数据用于训练,支持私有化部署

- **多模态能力**:原生支持文本、图像、视频统一处理,可直接解析设计稿、截图和各类办公文档

### 3.2 交互式配置向导(推荐)

运行以下命令启动配置向导,按提示完成 Kimi 模型配置:

```Bash
hermes setup
  1. 当提示选择 LLM 服务时,选择 Kimi/Moonshot China
  2. 输入你的 Kimi API Key(获取方式见下文)
  3. 选择默认模型,推荐 Moonshot/Kimi-K2.6
  4. 开启基础工具权限(新手建议勾选 web、terminal、file)

3.3 Kimi API Key 获取与手动配置

步骤 1:获取 Kimi API Key
  1. 访问Kimi开放平台并注册登录
  2. 点击左侧菜单栏「API Key 管理」
  3. 点击「新建 API Key」,输入名称后点击「确定」
  4. 复制弹出的密钥(仅显示一次,请妥善保存)
步骤 2:命令行手动配置(高级用户)

也可通过命令直接配置 Kimi 模型,无需交互式向导:

复制代码
# 设置默认模型为 Kimi-K2.6
hermes config set model Kimi/Moonshot-K2.6
# 配置 Kimi API Key
hermes config set KIMI_API_KEY sk-你的API密钥

3.4 其他模型配置补充

如需使用其他模型,可在配置向导中选择或手动添加:

  • OpenAI
复制代码
    hermes config set model.provider openai
    hermes config set model.api_key sk-你的OpenAI密钥
    ```

- **Anthropic Claude**

    

```Bash
    hermes config set model.provider anthropic
    hermes config set model.api_key sk-ant-你的Claude密钥
    ```

- **本地模型(Ollama)**

    

```Bash
    # 先安装 Ollama 并拉取模型
    ollama pull nous-hermes2
    # 配置本地推理
    hermes model --local ollama:nous-hermes2
    ```

## 四、启动验证与基础使用

### 4.1 首次启动与对话测试

配置完成后,直接输入以下命令启动聊天界面:

```Bash
hermes

看到 What can I do for you today? 提示即表示启动成功,输入问题开始交互:

复制代码
> 你好,请介绍一下你自己
> 查看当前系统的磁盘使用情况,找出占用空间最大的目录

4.2 两种运行模式

  • 单次模式:直接在命令后加指令,适合一次性简单任务
复制代码
    hermes "帮我统计当前目录下的 Python 文件数量"
    # 指定模型运行
    hermes --model openai/gpt-4o "分析这段代码的性能问题"
    ```

- **交互模式**:进入多轮对话,保持上下文记忆,适合复杂任务

    

```Bash
    hermes -i
    # 进入后可连续提问
    你: 查看 /etc/nginx/nginx.conf 的内容
    你: 把 worker_processes 改成 auto
    你: 测试配置是否有语法错误
    ```

### 4.3 常用快捷命令

在交互模式下输入以下命令可快速操作:

|**命令**|**功能**|
|---|---|
|`/help`|查看所有可用命令|
|`/skill list`|查看已安装的技能列表|
|`/skill run <技能名>`|运行指定技能|
|`/save <会话名>`|保存当前会话|
|`/exit` 或 `Ctrl+C`|退出 Hermes Agent|

## 五、常见问题排查

### 1. 安装失败

- 检查网络连接,重新配置 1.3 节的国内镜像加速

- 不要使用 `sudo` 执行安装命令,脚本会自动在用户目录安装

- 手动安装缺失的基础工具:`sudo apt install git curl build-essential`

### 2. 提示 `hermes: command not found`

- 重新执行环境变量刷新命令:`source ~/.bashrc` 或 `source ~/.zshrc`

- 关闭当前终端,重新打开新终端即可生效

- Windows 用户:手动将 `%LOCALAPPDATA%\hermes\bin` 添加到系统 PATH

### 3. 模型连接失败

- 核对 API Key 是否正确,无多余空格或换行

- 检查对应平台账户是否有足够余额

- 本地 Ollama 模型:确保服务已启动(`ollama serve`)且模型已拉取完成

### 4. 网络超时

- 国内用户优先使用 Kimi 模型,无需代理

- 如需使用海外模型,在配置文件 `~/.hermes/config.yaml` 中添加代理:

    

```YAML
    proxy:
      http: "http://127.0.0.1:7890"
      https: "http://127.0.0.1:7890"
    ```

### 5. Python 版本错误

- 提示 `Python 3.10+ required` 时,安装对应版本:

    

```Bash
    # Ubuntu/Debian
    sudo apt install python3.11 python3.11-venv
    # macOS
    brew install python@3.11
    ```

## 六、版本更新与卸载

### 版本更新

Hermes Agent 更新频繁,建议定期升级获取最新功能:

```Bash
# 一键更新(所有安装方式通用)
hermes update

# 对应安装方式手动更新
pip install --upgrade hermes-agent       # pip 安装
pipx upgrade hermes-agent                # pipx 安装
cd hermes-agent && git pull && pip install -e .  # 源码安装

完全卸载

复制代码
rm -rf ~/.hermes ~/.local/bin/hermes
# Docker 部署卸载
docker stop hermes-agent
docker rm hermes-agent
docker rmi nousresearch/hermes-agent:latest

七、进阶使用指引

  1. 日常任务体验:让 Hermes 协助处理文件整理、代码编写、系统运维等熟悉的任务,观察其推理和执行流程
  2. 自定义技能 :进入 ~/.hermes/skills/ 目录,查看自动生成的技能文件,学习并编写自己的专属技能
  3. 社区交流:前往 Cocoloop 社区,参考其他开发者分享的实用技能模板和配置方案
  4. 深入学习:研读项目 GitHub 源码,理解 Agent 的核心工作原理和自进化机制

使用过程中遇到问题,可在项目 GitHub Issues 或官方社区提问,维护团队响应及时。

相关推荐
csdn_aspnet3 小时前
Docker MySql 5.7、MySql8.x 进阶配置
mysql·docker·容器
怕浪猫4 小时前
全球 3D 网络地球的实时通信节点,来看看这四种交互地球,满足你对物理互联网的所有好奇
面试·架构·github
Csvn5 小时前
同一个问题问 100 遍,钱就扣 100 次?精确缓存让它只扣一次(C02)
人工智能·aigc·agent
岁月宁静6 小时前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
wflynn6 小时前
GitHub 今日推荐|kiri:clone3 系统调用直达容器,2.5 毫秒启动无 runc 中间层
docker·rust·kubernetes·开源·github·containers
可乐ea7 小时前
MCP 和 CLI 差 42 倍:一次 GitHub 任务的上下文成本实测
人工智能·github·工具调用·ai智能体·openrouter·mcp协议·上下文优化
小七-七牛开发者8 小时前
周 1 上线 | DSH 喜提原神进场动画,Anthropic 启动 IPO 路演;黄仁勋辞任;微软全球大宕机超 24 小时
ai·大模型·agent·token·工作流·claudecode·ai coding
泯泷8 小时前
Multica 真正打动我的,不是更多 Agent,而是一种新的团队协作方式
人工智能·llm·agent
逛逛GitHub8 小时前
Claude 最新模型发布 1 周了,瞧瞧外网惊艳到震撼的玩法。
github
逛逛GitHub8 小时前
最近逛 GitHub 挑了 8 个刚开源、Star 涨得挺快的项目。
github