核心结论：推荐使用官方一键安装脚本（最快2分钟完成），适配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原生：Early Beta阶段，功能可能受限

• 硬件要求：最低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、Linux/macOS/WSL2（最稳定）

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

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  # 检查依赖完整性

2、Windows原生（PowerShell）

• 以普通用户打开PowerShell（非管理员）

• 执行安装命令：

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

• 安装完成后重启PowerShell，验证：

hermes doctor

注意：Windows原生为Early Beta，部分功能可能不稳定，推荐优先使用WSL2

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优化流程

1. 备选快速安装（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 协议的服务

配置记忆存储：默认SQLite（轻量），可改为PostgreSQL/Redis

启用技能：选择需要的内置技能（终端执行、文件操作、网页检索等）

2、手动配置模型

hermes model  # 查看可用模型
hermes model set default <model-name>  # 设置默认模型

3、启动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 命令也很方便。

不过有一点要注意，装完必须填密钥才能用，建议先跑个hermes setup把基础配置弄好，再开始体验这个能自己进化的 AI。

特别提醒国内的朋友，配 Kimi 大模型是咱们的优选方案，打开就能用；中文理解比很多国外模型强太多，长文档、论文、代码库直接拖进去都能处理；写代码、调用工具、干各种复杂活都不在话下，和 Hermes 配合起来，你的工作效率直接起飞！