Hermes Agent 完整安装教程

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

要在 Windows 11 上成功部署和配置 Hermes Agent 与 LobChat，核心在于利用 WSL2 创建一个兼容的 Linux 环境，因为 Hermes Agent 原生不支持 Windows 操作系统 [ref_1]。以下是详细的部署与配置步骤。

此步骤确保你的 Windows 11 系统满足运行 Hermes Agent 的所有先决条件。

项目	要求/操作	说明
操作系统	Windows 11	需确保系统为较新版本，以支持 WSL2。
WSL2 安装	在 PowerShell（管理员）中运行 `wsl --install`	此命令默认安装 Ubuntu 发行版和 WSL2。安装后需重启系统 [ref_1]。
Git	在 WSL2 的 Ubuntu 终端中运行 `sudo apt update && sudo apt install git -y`	这是 Hermes Agent 一键安装脚本的唯一必需软件 [ref_1]。
Node.js 与 Python	无需手动安装	Hermes Agent 的安装脚本会自动处理 Python 3.11+ 和 Node.js 的安装 [ref_2]。

在 WSL2 的 Ubuntu 终端中执行以下步骤。

步骤 1：执行一键安装脚本 安装脚本会自动克隆仓库、设置 Python 环境、安装依赖并配置 CLI [ref_2]。

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

步骤 2：重新加载 Shell 配置 安装完成后，需要让新的环境变量生效。

source ~/.bashrc # 或者，如果你使用的是 Zsh： # source ~/.zshrc

步骤 3：验证安装 运行以下命令检查是否安装成功。

hermes version

如果看到类似 Hermes Agent v0.x.x 的版本信息，则说明安装成功 [ref_2]。

首次使用需要进行基础配置，主要是选择模型提供商和 API。

步骤 1：运行配置向导 推荐使用 hermes setup 命令进行快速交互式配置 [ref_3]。

hermes setup

你也可以选择分步配置：

hermes model # 配置模型 hermes tools # 配置工具

步骤 2：选择模型提供商与 API Key 在配置向导中，你会被引导完成以下关键选择 [ref_2]：

选择 LLM 提供商：为了获得免费额度，建议选择 OpenRouter [ref_2]。
输入 API Key：粘贴你从 OpenRouter 获取的 sk- 开头的 API 密钥 [ref_2]。
选择模型：在模型列表中，可以选择免费且性能不错的模型，例如 nvidia/nemotron-3-super-120b-a12b:free [ref_2][ref_3]。

步骤 3：配置工具与后端 配置向导还会引导你配置终端后端（如 mini-swe-agent）、消息平台（如 Slack、Discord）以及其他工具（如网页浏览、文件操作）。这些可根据你的实际需求进行选择，初次使用可接受默认或跳过 [ref_2]。

LobChat 是一个基于 Web 的聊天界面，用于与 Hermes Agent 交互。假设你已经完成了 Hermes Agent 的配置。

步骤 1：克隆 LobChat 仓库 在 WSL2 终端中，找一个合适的目录克隆项目。

git clone https://github.com/your-org/lobchat.git # 请替换为实际的 LobChat 仓库地址 cd lobchat

步骤 2：安装 LobChat 依赖 LobChat 通常是一个 Node.js 项目，使用 npm 或 yarn 安装依赖。

npm install # 或 yarn install

步骤 3：配置 LobChat 连接 Hermes Agent LobChat 需要通过配置文件或环境变量连接到 Hermes Agent 的服务。关键配置项通常包括：

Hermes Agent API 地址：默认为 http://localhost:8000（具体端口需根据 Hermes Agent 的实际启动端口调整）。
API 密钥或认证方式：如果 Hermes Agent 启用了认证，需要在此处配置。

你需要查阅 LobChat 项目的具体文档，修改其配置文件（如 .env 或 config.json）。

# 示例：编辑环境变量文件 cp .env.example .env nano .env # 在 .env 文件中设置： # HERMES_AGENT_URL=http://localhost:8000 # HERMES_API_KEY=your_hermes_api_key_if_any

步骤 4：启动 LobChat 服务 在 LobChat 项目目录下，启动开发服务器。

npm run dev # 或 yarn dev

启动后，根据终端输出的提示（通常是 http://localhost:3000），在 Windows 的浏览器中访问该地址，即可打开 LobChat 界面。

启动 Hermes Agent 服务：在 WSL2 终端中，确保在 Hermes Agent 项目目录下，启动其服务。具体启动命令需参考 Hermes Agent 文档，可能是 hermes start 或 python -m hermes_agent.server。
启动 LobChat 服务：在另一个 WSL2 终端标签页中，进入 lobchat 目录并运行 npm run dev。
打开浏览器：在 Windows 11 的 Chrome 或 Edge 浏览器中，访问 LobChat 的地址（如 http://localhost:3000）。
开始对话：在 LobChat 界面中输入问题，LobChat 会将请求发送给 Hermes Agent，Hermes Agent 处理后会返回结果并显示在聊天界面中。

依赖安装失败：如果在安装 Hermes Agent 过程中出现 Python 依赖问题，可以尝试在 WSL2 中先升级 pip 和基础工具，再重新运行安装脚本或安装依赖 [ref_3]。
```
 pip install --upgrade pip setuptools wheel 
```
环境诊断：使用 hermes doctor 命令可以检查 Hermes Agent 的环境配置和依赖是否存在问题 [ref_3]。
本地模型选项：如果你希望完全离线运行，可以考虑使用 Ollama 在本地部署模型，然后在 hermes model 配置中选择 Ollama 作为提供商 [ref_3]。
端口冲突：确保 Hermes Agent 和 LobChat 使用的端口（如 8000 和 3000）没有被其他程序占用。

通过以上步骤，你可以在 Windows 11 上，借助 WSL2 构建一个完整的 Hermes Agent 智能体运行环境，并通过 LobChat 提供的友好 Web 界面与其进行交互。整个方案的核心是将 Linux 生态的工具链无缝迁移到 Windows 系统中 [ref_1]。