Hermes Agent 提供五种安装方式：一、Linux 一键安装；二、Windows PowerShell 免 WSL 安装；三、WSL2+Ubuntu 手动部署；四、macOS Homebrew 极简安装；五、Docker 容器化部署。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在本地或服务器上部署 Hermes Agent，但遇到依赖缺失、模型无法调用或平台接入失败等问题，则很可能是安装流程未覆盖关键前置条件或配置顺序有误。以下是确保 Hermes Agent 正确安装的多种可行路径，适用于不同操作系统与使用场景：
一、Linux 系统一键安装（推荐 Ubuntu/Debian）
该方式通过官方脚本自动下载、校验并安装 Hermes Agent 核心程序及必要运行时依赖，避免手动环境冲突。适用于具备终端访问权限的云服务器或 WSL2 环境。
1、打开终端，执行以下命令：
curl -fsSL https://get.hermes.chat | bash
2、安装完成后，验证是否成功启动：
hermes --version
3、若提示 command not found，请检查 ~/.hermes/bin 是否已加入 PATH，可执行以下命令临时生效：
export PATH="$HOME/.hermes/bin:$PATH"
4、为永久生效，将上述 export 行追加至 ~/.bashrc 或 ~/.zshrc：
echo 'export PATH="$HOME/.hermes/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
二、Windows 系统 PowerShell 安装（免 WSL）
此方法不依赖 Linux 子系统，直接在原生 Windows 环境中完成全栈部署，适合希望快速试用且不熟悉 WSL 的用户。
1、以管理员身份打开 PowerShell；
2、执行安装脚本：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
3、脚本将自动检测并安装 Python 3.11+、Node.js、Git、ripgrep 等全部依赖；
4、安装完成后，关闭并重新打开 PowerShell，运行：
hermes setup
5、在向导中选择 Quick setup，按提示完成初始化；
6、若后续发现模型未识别，需手动执行 /model 命令指定模型名称，否则对话将无响应。
三、WSL2 + Ubuntu 手动部署（高可控性）
适用于对环境有严格控制需求的用户，例如需固定 Python 版本、启用特定编译工具链或集成自定义模型后端。该路径跳过一键脚本，全程由用户主导依赖管理。
1、启用 WSL2 并安装 Ubuntu 22.04 LTS（通过 Microsoft Store）；
2、在 Ubuntu 中更新系统并安装核心依赖：
sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential python3.12 python3.12-venv python3.12-dev nodejs npm git ripgrep ffmpeg curl wget
3、克隆 Hermes Agent 源码至标准路径：
git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
4、进入目录并使用 uv 创建虚拟环境：
cd ~/.hermes/hermes-agent && uv venv venv --python 3.12
5、激活环境并安装可编辑模式依赖：
source venv/bin/activate && uv pip install -e ".[all]"
6、验证安装结果：
hermes init
四、macOS 系统 Homebrew 安装（极简流程）
针对 macOS 用户提供最轻量级安装方式，利用 Homebrew 包管理器统一维护版本与依赖，适合开发测试阶段快速上手。
1、确保已安装 Homebrew，若未安装则执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2、执行 Hermes Agent 安装命令：
brew install hermes
3、安装后立即生成默认配置目录：
~/.hermes/config.yaml
4、首次运行 hermes 命令时，会自动触发交互式配置向导；
5、若配置文件未自动生成，可手动创建空文件并赋予写入权限：
mkdir -p ~/.hermes && touch ~/.hermes/config.yaml && chmod 600 ~/.hermes/config.yaml
五、Docker 容器化部署（生产就绪）
适用于需要隔离运行环境、多实例共存或与 CI/CD 流水线集成的场景。镜像内置所有依赖，无需宿主机预装 Python 或 Node.js。
1、确保已安装 Docker 及 Docker Compose；
2、拉取官方镜像（以最新稳定版为准）：
docker pull ghcr.io/nousresearch/hermes-agent:latest
3、创建 docker-compose.yml 文件，内容如下：
version: '3.8'
services:
hermes:
image: ghcr.io/nousresearch/hermes-agent:latest
volumes:
- ~/.hermes:/root/.hermes
environment:
- HERMES_MODEL_PROVIDER=custom
- HERMES_MODEL_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
- HERMES_MODEL_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
- HERMES_MODEL_DEFAULT=qwen-turbo
4、启动容器：
docker-compose up -d
5、进入容器验证运行状态：
docker exec -it hermes-agent-hermes-1 hermes --help
