速览：推荐一键安装（Linux/macOS/WSL2用curl脚本，Windows用PowerShell脚本），中国大陆用户优先用国内镜像源，安装后通过hermes setup配置模型与API，国内用户注意，推荐搭配 Kimi 大模型使用，无需特殊网络，中文理解和智能体任务表现出色，最后hermes启动即可。

一、准备工作（必看）

系统要求

• Windows：10（2004+）/11；推荐WSL2（长期稳定），也支持原生PowerShell
• Linux：Ubuntu 20.04+、Debian 11+、Fedora 36+、Arch等主流发行版
• macOS：11+（Big Sur及以上），支持Intel/Apple Silicon
• Android：Termux（需开启存储权限）

网络与权限

• 建议科学上网（国际版）或用国内镜像源（推荐）
• Linux/macOS：无需sudo，脚本自动安装到用户目录
• Windows：PowerShell建议管理员权限（避免路径限制）

账号准备（可选）

国内用户大模型推荐：

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

海外用户大模型推荐：

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

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

1. 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

• 自动完成：安装uv包管理器、Python 3.11、克隆仓库、配置环境变量
• 安装后执行：source \~/\.bashrc（bash）或source \~/\.zshrc（zsh）刷新环境变量

2. Windows原生（PowerShell）

# 国际官方源
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

# 国内镜像源（推荐）
irm https://res1.hermesagent.org.cn/install.ps1 | iex

• 安装路径：%LOCALAPPDATA%\\hermes，自动配置便携Git Bash
• 无需额外安装Python，脚本自带依赖

3. Android（Termux）

• 安装Termux：Google Play或F-Droid下载
• 执行Linux同款命令：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

• 自动适配Termux环境，安装完成后直接输入hermes启动

三、手动安装（适合开发者/高级用户）

• 克隆仓库（含子模块）

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
# 若已克隆未拉取子模块：git submodule update --init --recursive

• 安装uv包管理器

curl -LsSf https://astral.sh/uv/install.sh | sh

• 创建并激活虚拟环境

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows

• 安装依赖并配置

uv pip install -e .
hermes setup  # 交互式配置向导

四、配置与启动（关键步骤）

• 基础配置

# 方式1：交互式向导（推荐新手）
hermes setup
# 方式2：直接选择模型
hermes model

配置选项：选择模型

• Kimi：输入API密钥，国内用户优选，网络稳定，处理能力强
• Nous Portal：通过OAuth登录，适合新手
• OpenRouter：输入API密钥，模型选择多
• 本地部署：选择Ollama，完全离线使用
• 输入API密钥、设置消息通道
• 本地推理配置（无需API）

# 安装Ollama（先安装Ollama客户端）
ollama pull nous-hermes2
hermes model --local ollama:nous-hermes2

• 启动Hermes Agent

# 启动聊天界面
hermes
# 后台运行（Linux/macOS）
hermes start
# 停止后台服务
hermes stop

• 成功启动会显示Hermes欢迎界面，即可开始对话

五、常见问题与解决方法

• 安装失败
  • 网络问题：切换国内镜像源或检查网络连接
  • 权限不足：Linux/macOS不要加sudo，Windows用管理员PowerShell
  • 依赖缺失：手动安装git、curl等基础工具（Linux：sudo apt install git curl）
• 命令未找到
  • 执行source \~/\.bashrc或source \~/\.zshrc刷新环境变量
  • Windows：重启PowerShell或手动添加%LOCALAPPDATA%\\hermes\\bin到系统PATH
• 模型连接失败
  • 核对API密钥是否正确，是否有足够额度
  • 本地Ollama：确保服务已启动（ollama serve），模型已正确拉取
• 更新Hermes Agent

hermes update  # 一键更新
# 或手动更新
cd ~/.hermes/hermes-agent
git pull
git submodule update --init --recursive
uv pip install -e .

六、结语

Hermes Agent 以极致简化的部署体验和强大的智能体核心能力脱颖而出，它支持 Windows、macOS、Linux 全主流操作系统通过单行命令一键完成安装，无需繁琐的环境配置，安装后跟随内置交互式配置向导即可快速接入大模型，即刻拥有一款具备持续自主学习能力、能调用各类工具、执行复杂长程任务的智能工作伙伴；针对国内用户，使用中文社区专属镜像源可大幅提升下载速度与稳定性，Windows 平台用户优先采用 WSL2 环境部署更能获得与 Linux 原生一致的流畅运行体验，而在大模型选型上，国内用户优选 Kimi 大模型堪称黄金搭档 —— 它无需额外网络配置即可直接访问，对中文语境的理解精准自然，更拥有业界领先的长文本处理能力，在代码生成、多工具调用及复杂任务执行方面表现优异，能与 Hermes Agent 的智能体特性深度契合，全方位助力用户高效完成各类自动化工作。