想快速上手Hermes Agent这个强大的智能体框架？最省心的办法就是直接使用官方提供的一键安装脚本。简单来说，Linux、macOS或WSL2用户用curl命令，Windows用户用PowerShell脚本。对于身处中国大陆的用户，强烈建议优先使用国内镜像源，速度会快很多。安装完成后，通过 hermes setup 命令配置你喜欢的模型和API，就能轻松启动了。
一、准备工作（必看）
在动手之前，花一分钟确认好这几件事，能帮你避开99%的安装问题。
系统要求
- Windows：需要Windows 10（2004版本以上）或Windows 11。长期使用的话，WSL2环境是最稳定、最推荐的选择，当然原生PowerShell也支持。
- Linux：主流的发行版基本都行，比如Ubuntu 20.04、Debian 11、Fedora 36、Arch等。
- macOS：需要macOS 11（Big Sur）或更高版本，Intel和Apple Silicon芯片都支持。
- Android：可以通过Termux应用安装，记得提前在Termux里开启存储权限。
网络与权限
- 网络：如果能访问国际网络，可以直接用官方源。如果下载缓慢或连接不稳定，使用国内镜像源是更明智的选择，速度会有质的提升。
- 权限：在Linux和macOS上运行安装脚本不需要使用sudo，它会自动安装到你的用户目录下。在Windows上，建议以管理员身份运行PowerShell，这样可以避免因路径权限导致的一些小麻烦。
账号准备（可选）
Hermes Agent本身是开源的，但要发挥其智能体的能力，你需要为它配置一个“大脑”——也就是大模型API。以下是针对不同用户群体的推荐：
国内用户大模型推荐：
- 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）来刷新环境变量，这样 hermes 命令才能立刻生效。
2. Windows原生（PowerShell）
以管理员身份打开PowerShell，执行：
# 国际官方源
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
# 国内镜像源（推荐）
irm https://res1.hermesagent.org.cn/install.ps1 | iex
脚本会将Hermes Agent安装到 %LOCALAPPDATA%\hermes 目录，并自动配置好便携版的Git Bash，你不需要额外安装Python。
3. Android（Termux）
首先，从Google Play或F-Droid下载并安装Termux应用。打开Termux后，执行和Linux一样的命令即可：
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
脚本会自动适配Termux的环境。安装完成后，直接在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 # 启动交互式配置向导
四、配置与启动（关键步骤）
安装完成只是第一步，配置好模型才能让Hermes Agent真正“活”起来。
基础配置
运行以下命令开始配置：
# 方式1：交互式向导（推荐新手）
hermes setup
# 方式2：直接选择模型
hermes model
配置选项：选择模型
接下来，你会面临最重要的选择：为Hermes Agent选择一个“大脑”。
- Kimi：输入你的API密钥即可。这是国内用户的黄金选择，网络稳定，长文本和复杂任务处理能力突出。
- Nous Portal：可以通过OAuth直接登录，对新手非常友好。
- OpenRouter：输入API密钥，然后就可以在它支持的上百个模型中自由切换。
- 本地部署：选择Ollama，体验完全离线的智能体。这需要你先在电脑上安装并运行Ollama服务。
根据提示，输入对应模型的API密钥，并设置好消息通道（如Discord、Telegram等，如果需要）。
本地推理配置（无需API）
如果你想完全离线运行，需要先安装Ollama客户端，并拉取模型：
# 安装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等基础工具。例如在Ubuntu/Debian上可以运行：
sudo apt install git curl。
- 命令未找到
- 安装完成后，记得执行
source ~/.bashrc或source ~/.zshrc来刷新环境变量。 - Windows用户：可以尝试重启PowerShell，或者手动将
%LOCALAPPDATA%\hermes\bin添加到系统的PATH环境变量中。
- 安装完成后，记得执行
- 模型连接失败
- 仔细核对输入的API密钥是否正确，并确认该密钥是否有足够的调用额度。
- 如果使用本地Ollama，请确保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用户如果追求最丝滑的体验，优先采用WSL2环境部署会是个好主意。而在大模型的选择上，国内用户搭配Kimi堪称“黄金组合”——无需额外网络配置，对中文语境的理解精准又自然，再加上业界领先的长文本处理能力，无论是代码生成、多工具调用还是复杂任务执行，都能与Hermes Agent的智能体特性深度契合，全方位提升你的工作效率。
