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 的智能体特性深度契合，助力用户高效完成各类自动化工作。

posted @ 2026-05-26 15:53  博客万  阅读(86)  评论(0)    收藏  举报