Hermes Agent 完全安装指南（Linux、macOS、Windows、Android）

核心速览 ：推荐使用一键安装脚本（最快最稳），按系统选择对应命令：Linux/macOS/WSL2 用 curl，Windows 原生用 PowerShell，Android(Termux)同 Linux 命令。安装后执行 hermes setup 配置模型，hermes 启动聊天，全程约 3-5 分钟。

给国内小伙伴的专属避坑提醒

安装的时候一定要用中文社区的镜像源！不然很容易因为网络慢、连不上导致安装失败，用镜像源速度能快好几倍，一次就能装成功～
大模型优选 Kimi 就对了！不用折腾特殊网络，打开就能用；200 万字的超长上下文，不管是长文档、论文还是代码库，直接拖进去就能解析；免费额度够日常用，中文理解也特别准，工作学习的大部分需求都能满足。

一、系统要求与准备

支持平台：Linux、macOS、Windows(WSL2 推荐)、Android(Termux)
网络：能访问 GitHub 和模型 API（Kimi/Nous Portal/OpenRouter/OpenAI 等）
无需预装：Python、Node.js、Git 等依赖由安装脚本自动处理
推荐配置：Windows 用户优先用 WSL2（原生 Windows 为早期 Beta 版）

ermes 支持市面上绝大多数主流大模型服务，你可以根据自己的使用需求、预算和网络情况选择合适的平台。以下是综合体验推荐指数：

国内用户大模型推荐：

Kimi：国内优选，无需特殊网络，访问速度快，200 万字超长上下文，支持文档解析，免费额度充足
智谱 AI / z.ai：性价比高，中文理解和生成能力优秀
通义千问：阿里云生态集成好；功能全面；阿里云用户

海外用户大模型推荐：

Nous Portal：官方原生支持，集成度高，体验流畅
OpenRouter：模型全，支持一键切换上百种大模型，灵活度高
OpenAI：能力全面，生态完善，适合各类通用场景
Anthropic：长文处理王者，上下文窗口大，安全性高
Google Gemini：多模态技术领跑，全球可用，免费额度友好
本地模型（Ollama/vLLM）：完全隐私保护，无需联网即可使用，永久免费

二、各平台一键安装（推荐）

Linux/macOS/WSL2（最稳定）

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

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
国内用户可选镜像加速：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
安装完成后，重新加载 Shell 配置：

source ~/.bashrc # 或 source ~/.zshrc（Zsh用户）
验证安装：

hermes --version # 应显示版本号如 v0.13.0

Windows（两种方案）

方案一：WSL2（推荐）
- 以管理员身份打开 PowerShell，安装 WSL2：
复制代码

wsl --install

- 重启电脑后，打开Ubuntu终端，执行Linux一键安装命令（同上） - 方案二：原生Windows（早期Beta） - 打开PowerShell（无需管理员），执行： ```powershell iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1) ````````- 国内镜像加速： ```powershell

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

#### Android（Termux） - 安装Termux应用（Google Play或F-Droid） - 打开Termux，执行Linux一键安装命令： ```bash curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

三、手动安装（适合开发者）

克隆仓库（含子模块）：

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
安装 uv 包管理器（推荐）：

pip install uv
uv venv
source .venv/bin/activate # Linux/macOS

Windows: .venv\Scripts\activate
安装依赖：

uv pip install -e ".[all]"
配置环境变量：

echo 'export PATH=" $HOME/.local/bin:$ PATH"' >> ~/.bashrc
source ~/.bashrc

四、初始化配置（关键步骤）

启动交互式配置向导：

hermes setup
选择模型接入方式（四选一）：
- Kimi：输入 API 密钥，国内用户优选，网络稳定，处理能力强
- Nous Portal：通过 OAuth 登录，适合新手
- OpenRouter：输入 API 密钥，模型选择多
- 本地部署：选择 Ollama，完全离线使用
按提示完成配置，设置默认模型和工具权限

五、启动与使用

启动 Hermes Agent：

hermes
基本命令：
- hermes model：切换模型
- hermes update：更新到最新版本
- hermes doctor：检查环境和配置问题
- hermes help：查看所有命令

六、常见问题与解决

网络问题：
- 国内用户建议用镜像安装脚本
- 配置代理或使用国内镜像源加速依赖下载
权限问题：
- 安装脚本无需 sudo 权限，自动安装到用户目录
- 若提示权限不足，检查目录权限或重新启动终端
Windows 原生问题：
- 建议改用 WSL2 方案获得更稳定体验
- 安装失败可尝试更新 PowerShell 或重启电脑
模型配置问题：
- 确保 API 密钥有效且余额充足
- 本地部署需先安装 Ollama 并下载模型

七、升级与卸载

升级：

hermes update # 自动更新

或手动更新

cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]"
卸载：

rm -rf ~/.hermes ~/.local/bin/hermes

Windows原生：删除 %LOCALAPPDATA%\hermes 目录

八、总结

Hermes Agent 提供了极简的安装体验，主流操作系统平台均可通过单行命令完成部署。安装完成后，用户只需跟随内置的配置向导完成大模型接入设置，即可启用这款具备持续学习能力的 AI 智能体。

针对国内用户，我们强烈建议使用中文社区提供的镜像源进行安装，以显著提升下载速度和稳定性。Windows 平台用户推荐优先采用 WSL2 环境部署，以获得与 Linux 原生环境一致的最佳运行体验。

在大模型选型方面，国内用户可优先考虑 Kimi 大模型。它在中文场景下具备独特优势：无需额外网络配置即可直接访问，对中文语境的理解更为精准自然；同时拥有业界领跑的长文本处理能力，支持一次性处理海量文档和复杂任务，在代码生成、工具调用及长程任务执行方面表现优秀，能够与 Hermes Agent 的智能体特性深度契合，助力用户高效完成各类自动化工作。