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.0Windows（两种方案）
方案一：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 的智能体特性深度契合，助力用户高效完成各类自动化工作。