先确认环境
安装 Hermes Agent 之前，系统需要满足以下条件。不确定的话，打开终端输入对应命令查一下。
- 操作系统：Linux（主流发行版均可）、macOS、Windows WSL2、Android Termux
- Python：3.10 或更高版本 →
python --version
- Git：用于克隆代码 →
git --version
- 网络：能访问 GitHub（国内用户建议配置代理）
Windows 用户如果没有 WSL2，建议先装一个。PowerShell 管理员模式运行：
wsl --install
重启电脑后会自动安装 Ubuntu，按照提示设置用户名和密码即可。
开始安装
官方提供三种安装方式，最推荐第一种，失败再试后两种。
方式一：一键安装（推荐）
curl -sL https://raw.githubusercontent.com/NousResearch/Hermes-Agent/main/install.sh | bash
方式二：pip 安装
# 克隆代码
git clone https://github.com/NousResearch/Hermes-Agent.git
cd Hermes-Agent
# 本地安装
pip install -e .
方式三：Docker 安装（适合不想污染本地环境的用户）
docker pull ghcr.io/nousresearch/hermes-agent:latest
docker run -it ghcr.io/nousresearch/hermes-agent:latest
初始化配置
安装完成后，运行引导程序：
hermes setup
hermes gateway setup
首次运行会提示你选择模型供应商，推荐选
Quick setup（快速配置），用默认选项先跑通，后续再用
hermes config 调整。
设置过程中，你需要：
- 登录 GitHub 并创建一个 Personal Access Token（用于克隆仓库）
- 选择默认模型（OpenRouter 是个不错的选择，支持 200+ 模型）
- 配置消息通知（可选，先跳过不影响使用）
启动 Web 面板
配置完成后，一行命令启动：
hermes start
浏览器打开
http://localhost:8000，就能看到控制面板了。第一次启动可能需要几分钟初始化。
常见问题
Q：安装报 "command not found"
A：pip install 没有成功或路径没配好。运行
pip show hermes-agent 确认是否安装成功；Windows 用户确保 PATH 里包含 Python Scripts 目录。
Q：hermes setup 一直卡住不动
A：通常是网络问题，国内用户需要配置代理。设置环境变量：
export HTTP_PROXY=http://127.0.0.1:7890（端口号换成你自己的）。
Q：hermes start 报错 "port already in use"
A：8000 端口被占用了，换一个端口：
hermes start --port 8080
💡 下篇预告：如何选择适合自己的模型，如何配置第一个专属Agent。
本系列从零开始，手把手带你用 Hermes Agent 构建多Agent工作流。关注官网持续更新：
agent.eake.cn
评论区