Hermes Agent怎么安装才正确_Hermes Agent安装配置教程【详解】

Hermes Agent 提供五种安装方式：一、Linux 一键安装；二、Windows PowerShell 免 WSL 安装；三、WSL2+Ubuntu 手动部署；四、macOS Homebrew 极简安装；五、Docker 容器化部署。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

如果你在本地或服务器上部署 Hermes Agent 时，遇到了依赖缺失、模型调用失败或者平台接入不上的问题，别急着怀疑工具本身。很多时候，问题恰恰出在安装流程上——要么漏掉了关键的前置条件，要么配置顺序出了岔子。为了帮你一次搞定，这里梳理了五种经过验证的安装路径，覆盖了从快速尝鲜到生产部署的主流场景。

一、Linux 系统一键安装（推荐 Ubuntu/Debian）

对于大多数拥有终端访问权限的云服务器或 WSL2 环境来说，这是最省心的选择。官方脚本会自动处理下载、校验以及核心程序和运行时依赖的安装，能有效避免手动配置时常见的环境冲突。

操作起来很简单：

1、打开终端，直接运行这条命令：

curl -fsSL https://get.hermes.chat | bash

2、安装完成后，先别急着进行下一步，验证一下是否成功启动：

hermes --version

3、如果系统提示 command not found，别慌。这通常意味着安装目录没有自动加入系统的 PATH 环境变量。你可以先执行下面这条命令让它临时生效：

export PATH="$HOME/.hermes/bin:$PATH"

4、当然，为了永久生效，更推荐把上面这行命令追加到你的 shell 配置文件里，比如 ~/.bashrc 或 ~/.zshrc：

echo 'export PATH="$HOME/.hermes/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

二、Windows 系统 PowerShell 安装（免 WSL）

不想折腾 WSL？这个方法就是为你准备的。它直接在原生的 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 工具创建一个独立的 Python 虚拟环境：

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 流水线无缝集成时，容器化部署就成了不二之选。Docker 镜像已经内置了所有依赖，宿主机无需预装 Python 或 Node.js 等任何环境。

部署方法：

1、前提是确保宿主机已经安装了 Docker 和 Docker Compose；

2、拉取官方的稳定版镜像：

docker pull ghcr.io/nousresearch/hermes-agent:latest

3、创建一个 docker-compose.yml 文件，内容参考如下（注意替换其中的 API 密钥等敏感信息）：

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

这就是Hermes Agent怎么安装才正确_Hermes Agent安装配置教程【详解】的全部内容了，希望以上内容对小伙伴们有所帮助，更多详情可以关注我们的菜鸟游戏和软件相关专区，更多攻略和教程等你发现！