先放一个核心结论：Hermes Agent 安装这件事，推荐所有用户优先走官方一键安装脚本。这个方案的兼容性很强，Linux、macOS、WSL2、Android（Termux）四大平台都能通吃；Windows 原生系统则通过 PowerShell 命令来完成。至于那些有自定义配置需求的开发者，手动安装模式也完全开放。不管用哪种方式，装完后只需要执行一条 hermes setup 命令，模型和 API 参数配置就能走完，然后直接启用全部功能。

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

最优大模型选择：优先用 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 运行技能
• 保存会话：输入 /sa ve 保存当前会话
• 退出：输入 /exit 或按 Ctrl+C

八、结语

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

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

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