Hermes Agent 智能体的安装主要有两种方式，全流程

3天前发布

140

Hermes Agent 的安装主要有两种方式：对于大多数用户，推荐使用一键自动安装；如果你需要更精细的控制，可以选择手动安装。

✅ 方式一：一键自动安装（推荐）

这是最快、最省心的方式，安装程序会自动处理所有依赖和环境配置。

准备环境：
- 操作系统：Hermes Agent 官方支持 macOS、Linux 或 Windows 的 WSL2 环境，暂不支持Windows原生系统。
- 必备工具：确保已安装 Git。其他依赖（如Python, Node.js）安装脚本会自动处理。
- API Key：提前准备好一个支持的 LLM 服务商的 API Key，例如 OpenAI、Anthropic、Kimi、阿里云 DashScope 或本地 Ollama 等。
执行安装命令：根据你的操作系统，在终端中执行对应的命令：
- macOS / Linux / WSL2: 打开终端，执行：
```
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

*   **Windows (在WSL2中)**: 按官方指南安装并进入 WSL2 环境后，使用上述命令。WSL2内的安装方式与Linux环境完全相同，因此只需执行相同的`curl`命令即可。
    如果不确定WSL2如何安装，可以参考微软官方文档或社区教程。

完成配置：
- 安装完成后，执行 source ~/.bashrc (或 source ~/.zshrc) 刷新终端配置，然后运行 hermes --version 验证是否安装成功。
- 首次运行通常会自动启动配置向导，跟随向导完成初始设置即可。如果向导未自动启动，可以手动执行 hermes setup 来配置 LLM 提供商和 API Key。

🛠️ 方式二：手动安装（高级）

如果你希望完全掌控安装过程，可以按照以下步骤操作。

克隆仓库：在终端中执行以下命令克隆项目及其子模块：

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

创建虚拟环境并安装依赖：

# 安装 uv (快速Python包管理器)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 使用Python 3.11创建虚拟环境
uv venv venv --python 3.11

# 安装所有核心依赖
export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"

验证安装：安装完成后，可以通过 hermes doctor 命令来全面检查系统环境、依赖和配置，确保一切就绪。

🗺️ 后续配置概览

完成安装后，你可以通过以下命令进行个性化配置：

hermes setup: 再次运行完整的配置向导。
hermes model: 选择或更换你的 LLM 提供商和模型。
hermes tools: 配置启用的工具集。
hermes gateway setup: 配置 Telegram、Discord 等消息平台接入。
hermes config set: 单独设置某个配置项。

💡 常见问题与排查

安装卡住或网络问题：由于网络原因，安装脚本下载依赖可能较慢或失败。可以尝试更换网络环境，或为终端配置代理。
模型未被识别：安装后可能出现模型列表为空的情况。可以尝试使用 /model 命令手动指定模型。
与飞书等平台对接：需要先在飞书开放平台创建机器人应用，获取 App ID 和 App Secret，然后在 Hermes 中通过 hermes gateway setup 进行配置。
依赖错误：如果遇到特定依赖（如 yaml, dotenv）缺失的错误，可以手动进入 Hermes 的虚拟环境进行安装。
环境检查：遇到任何问题时，首先运行 hermes doctor，它会给出详细的诊断信息，帮助快速定位问题根源。