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

zandy10112026-06-03 14:03

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 或官方社区提问，维护团队响应及时。

相关推荐
夜焱辰1 小时前
我花了3个月，把一个终端 AI Agent 搬进了浏览器——踩坑全记录
前端·agent
tech_zjf1 小时前
我如何把「会聊天的 AI」做成「会行动、会记忆、会成长」的社交 Agent
agent·全栈
Agilex松灵机器人1 小时前
松灵技术生态|IsaacLab中实现松灵PIPER机械臂键盘遥操作与数据采集教程
agent·强化学习·仿真·具身智能·skill·松灵机器人
searchforAI2 小时前
CC-Switch教程：统一管理Skills、MCP、模型供应商、系统提示词等多项配置
人工智能·gpt·ai·大模型·agent·claudecode
情绪总是阴雨天~2 小时前
Docker 基础概念完全指南：从零理解容器化技术
docker·容器
lqqjuly3 小时前
多智能体系统架构（Multi-Agent System Architecture）
系统架构·agent
科技道人3 小时前
Launcher allapps界面顶部推荐的app
git·github·launcher·allapps
LienJack3 小时前
《Re0 Build Harness》第五章 演化路径
agent
Soari3 小时前
从零训练 LLM：解析 GitHub 开源项目 train-llm-from-scratch
github·llm训练·从零训练大模型
热门推荐
01GitHub 镜像站点022026 年 AI 编程工具终极横评：Cursor vs Claude Code vs Copilot vs Windsurf03【AI】2026 年具身智能模型和世界模型总结04Codex 下载安装指南：Windows 和 macOS 官方版下载05【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法06裂开！ChatGPT 居然开始要手机号验证，附详细解决方法07CC-Switch 下载、安装与使用配置指南【2026.5.29】08Codex 桌面端更新后 Chrome 插件和 Computer Use 不可用，怎么排查和修复09CC-Switch & Claude 基于 Linux 服务器安装使用指南10Codex 接入 DeepSeek API 完整配置文档