2026年6月最新Hermes Agent安装教程（国内无特殊网络环境版）

一、核心安装结论

推荐优先使用官方一键安装脚本，该方案兼容性极强，全面适配Linux、macOS、WSL2、Android（Termux）四大平台；Windows原生系统需通过PowerShell命令完成安装。有自定义配置需求的开发者，可选择手动安装模式。所有方式安装完成后，仅需执行 hermes setup 命令，完成模型与API参数配置，即可正常启用Hermes Agent全部功能。

二、国内用户专属优化方案（无需特殊网络）

最优大模型选择：优先选用Kimi大模型，无需特殊网络即可稳定访问运行。该模型具备200万字超长上下文处理能力，免费额度充足、中文语义理解精准，完美适配Hermes Agent各类自动化办公、内容处理场景，是国内用户的最优选择。

三、安装前准备（全平台适配）

1. 适配平台与版本要求

• 通用推荐平台：Ubuntu 22.04+、Debian 12+等Linux系统、macOS 12+、WSL2、Android Termux
• Windows原生平台：需提前安装 PowerShell 7+ 及 Git for Windows 工具

2. 硬件与环境要求

• 内存配置：最低2GB内存，推荐4GB及以上内存，保障运行流畅度
• 网络要求：普通稳定联网环境即可，无需特殊网络代理
• 权限说明：全程无需root、sudo等高权限，程序默认安装至用户个人目录，安全无侵入

四、全场景大模型服务推荐

Hermes Agent兼容市面主流大模型服务，可根据网络环境、使用预算、功能需求自由选择。以下为分场景实测体验评分与适配推荐：

1. 国内用户首选（无特殊网络可用）

• Kimi（10/10）：国内适配度天花板，无需特殊网络、访问速度稳定，200万字超长上下文支持文档解析，免费额度充裕，中文适配性拉满，适配所有Hermes自动化场景
• 智谱AI/z.ai（8/10）：性价比突出，中文文本理解、内容生成能力优秀，日常基础使用完全够用
• 通义千问（8/10）：深度适配阿里云生态，功能全面、运行稳定，适合阿里生态用户联动使用

2. 海外用户首选

• Nous Portal（10/10）：官方原生适配模型，集成度最高，兼容性、运行流畅度最优
• OpenRouter（10/10）：模型库资源最全，支持一键切换上百种大模型，使用灵活性极强
• OpenAI（10/10）：综合能力全面、生态完善，适配各类通用型AI自动化场景
• Anthropic（8/10）：长文本处理领域标杆，超大上下文窗口，数据安全性极高
• Google Gemini（8/10）：多模态技术领先，全球服务器稳定，适配图文多场景处理需求

3. 本地离线部署方案

• Ollama（8/10）：支持纯离线运行，无需联网，全方位保障数据隐私安全，适配企业、个人对数据保密有严格要求的使用场景

二、快速安装（推荐所有用户）

1、Windows原生（PowerShell）

原生 Windows 无需 WSL 即可运行 Hermes——CLI、gateway、TUI 和工具均可原生运行

• 以普通用户打开PowerShell（非管理员）
• 执行安装命令：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

• 安装完成后重启PowerShell，验证：

hermes doctor

Windows原生安装后需注意

32 位 Windows 回退方案：自动降级为 MinGit，存在以下限制

• 缺少 bash 终端
• 禁用所有终端工具功能
• 禁用 agent 浏览器功能

安装执行流程

• 将 Hermes Agent 仓库克隆至本地路径：%LOCALAPPDATA%\hermes\hermes-agent
• 自动创建并配置 Python 虚拟环境
• 将hermes命令添加至用户级 PATH 环境变量

安装后必做操作

安装完成后，必须重启终端（或打开一个全新的 PowerShell 窗口），才能使 PATH 环境变量的修改生效。

2、Linux/macOS

打开终端，执行一键安装命令：

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

• 自动安装：uv（Python包管理器）、Python 3.11、Node.js、浏览器、ripgrep、ffmpeg等依赖
• 安装完成后，激活环境：

source ~/.bashrc  # 若用zsh：source ~/.zshrc

• 验证安装：

hermes doctor  # 检查依赖完整性

3、Android(Termux)

• 安装Termux应用（Google Play或F-Droid）
• 打开Termux，执行：

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

• 安装程序会自动检测Termux并切换到Android优化流程

备选快速安装（PyPI）

• 适合仅需稳定版本的用户：

pip install hermes-agent
hermes postinstall  # 可选：安装额外依赖（Node.js、浏览器等）

PyPI版本为正式发布版，不包含main分支最新特性

三、手动安装（开发者/高级用户）

1、克隆仓库（含子模块）

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

2、安装依赖（推荐用uv）

# 安装uv（若未安装）
pip install uv

# 创建虚拟环境
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
uv pip install -e .[all]  # 包含所有可选依赖

3、初始化配置

hermes setup  # 交互式配置向导

四、安装后配置（关键步骤）

1、首次运行设置

hermes setup  # 启动交互式配置

配置流程：

选择模型提供方：

• 国内用户首选：Kimi**，**输入 API 密钥即可快速连接，无需特殊网络环境，中文语境理解精准自然，支持 200 万字超长上下文与多格式文档解析，在代码编写、工具调用和长程任务执行方面表现出色，与 Hermes 智能体特性高度契合；也可选通义千问（性价比高）或智谱 AI（数学推理强）
• 当提示 "Select your LLM provider" 时，选择 Moonshot (Kimi, China)
• 输入你的 Moonshot API Key（获取方式见下文）
• 选择默认模型，推荐 moonshot/k2.6
• 开启基础工具权限（新手建议勾选 web、terminal、file）
• 完成配置后，向导会自动保存设置

2、Kimi API Key 获取与手动配置

步骤 1：获取 Kimi API Key

• 访问Kimi开放平台并注册登录
• 点击左侧菜单栏「API Key 管理」
• 点击「新建 API Key」，输入名称后点击「确定」
• 复制弹出的密钥（仅显示一次，请妥善保存）

步骤 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、配置文件路径说明

• Windows：%LOCALAPPDATA%\hermes\config.yaml 和 %LOCALAPPDATA%\hermes\.env

4、启动Hermes Agent

hermes  # 启动聊天界面

五、Nix/NixOS安装（高级用户）

1、Nix Flake方式

nix run github:NousResearch/hermes-agent

2、NixOS模块配置

• 在configuration.nix中添加：

services.hermes-agent = {
  enable = true;
  openFirewall = true;  # 可选：开放防火墙端口
  settings = {
    model = "Hermes-3-Llama-3-8B";
    # 其他配置...
  };
};

• 然后执行：

sudo nixos-rebuild switch

六、常见问题与解决方案

1、安装失败

• 网络问题：尝试更换网络或使用代理
• 依赖冲突：执行hermes clean后重新安装
• 权限问题：确保未使用root/sudo，安装在用户目录下

2、模型连接失败

• 检查API密钥是否正确
• 确认网络可访问模型端点
• 尝试切换模型或提供方

3、工具无法使用

• 检查是否在安装时启用了工具依赖
• 执行hermes doctor检查工具完整性
• 重新运行hermes postinstall安装缺失依赖

4、更新与卸载

# 更新
hermes update

# 完全卸载
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/uninstall.sh | bash

七、快速上手指南

• 启动聊天：hermes
• 查看帮助：在聊天界面输入/help
• 运行技能：输入/skill list查看所有技能，/skill run <skill-name>运行技能
• 保存会话：输入/save <session-name>保存当前会话
• 退出：输入/exit或按Ctrl+C

八、结语

Hermes Agent 的安装门槛极低。普通用户跑个一键脚本，几分钟就装好了；喜欢折腾的开发者可以手动编译源码；Windows 环境下也只需一条 PowerShell 命令。

注意：安装后必须配置 API 密钥才能运行。建议先用 hermes setup 把基础配置走完，再正式上手。

给国内用户的建议：优选Kimi 大模型。无需额外配置，开箱即用，中文理解能力突出，长文本、论文、代码库都能轻松消化。写代码、调工具、处理复杂任务样样在行，和 Hermes 组合使用，生产力直接拉满。