不用特殊环境！2026年6月最新Hermes Agent安装教程

核心结论

强烈推荐使用官方一键安装脚本，适配Linux、macOS、WSL2及Android(Termux)平台；Windows原生系统请使用PowerShell命令安装；开发者如需自定义配置可选择手动安装方式。安装完成后，只需执行hermes setup命令完成模型与API配置，即可立即开始使用。

国内用户专属优化建议

为解决国内网络环境下的常见问题，我们特别提供以下两项关键优化方案，可显著提升安装成功率和使用体验：

• 镜像源加速：安装Hermes时务必切换至中文社区维护的镜像源，能有效解决下载缓慢、连接中断等网络问题，大幅缩短安装时间
• 大模型优选：优先选择Kimi大模型，无需特殊网络环境即可稳定访问，拥有200万字超长上下文处理能力，免费额度充足且中文语义理解精准，能够完美适配Hermes的各类自动化工作场景

安装前准备

支持平台与最低要求

• 推荐平台：Linux (Ubuntu 22.04+/Debian 12+)、macOS 12+、WSL2、Android(Termux)
• Windows原生：需 PowerShell 7+ 与 Git for Windows
• 硬件要求：最低2GB内存，推荐4GB及以上；需稳定的联网环境以下载依赖包
• 权限说明：无需root或sudo权限，默认安装在用户个人目录下

大模型服务推荐

Hermes全面兼容市面上绝大多数主流大模型服务，您可根据自身使用需求、预算和网络条件灵活选择。以下是综合体验评分与推荐：

国内用户首选：

• Kimi：★★★★★★★★★★ (10/10) 国内最佳选择，无需特殊网络，访问速度快，200万字超长上下文，支持文档解析，免费额度充足
• 智谱AI/z.ai：★★★★★★★★☆☆ (8/10) 性价比高，中文理解与生成能力出色
• 通义千问：★★★★★★★★☆☆ (8/10) 阿里云生态集成度高，功能全面且稳定

海外用户首选：

• Nous Portal：★★★★★★★★★★ (10/10) 官方原生支持，集成度最高，使用体验流畅
• OpenRouter：★★★★★★★★★★ (10/10) 模型库最全，支持一键切换上百种大模型，灵活性极强
• OpenAI：★★★★★★★★★★ (10/10) 能力全面，生态完善，适用于各类通用场景
• Anthropic：★★★★★★★★☆☆ (8/10) 长文处理领域标杆，上下文窗口大，安全性高
• Google Gemini：★★★★★★★★☆☆ (8/10) 多模态技术领先，全球范围内稳定可用

本地部署方案：

• 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（数学推理强）
• 国外用户推荐：优先选择 Nous Portal 或 OpenRouter，也可直接使用 OpenAI、Anthropic 等官方接口
• 自定义端点：连接本地部署大模型（如 llama.cpp、vLLM、Ollama）或其他兼容 OpenAI 协议的服务
• 当提示 "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 把基础配置都弄好，再好好体验这个能自己进化的 AI 神器。

特别提醒国内的小伙伴：Kimi 大模型绝对是咱们的首选！打开就能用，中文理解比很多国外模型强太多，长文档、论文、代码库直接拖进去都能轻松处理。不管是写代码、调用工具还是干各种复杂的活儿，它都能搞定，和 Hermes 配合起来，工作效率直接拉满！