安装指南 - Hermes Agent 中文文档

首页 / 安装指南

系统要求

ⓘ

运行前准备：你需要一个支持工具调用（function calling / tool use）的 LLM API 密钥。推荐使用 Nous Portal，也支持 OpenAI、Anthropic、DeepSeek 等其他提供商。

支持的操作系统

操作系统	支持状态	安装方式
Linux (x86_64)	✓ 完全支持	一键脚本 / 手动安装
macOS (Intel & Apple Silicon)	✓ 完全支持	一键脚本 / 手动安装
WSL2 (Windows)	✓ 完全支持	一键脚本 / 手动安装
Android (Termux)	✓ 完全支持	一键脚本
Windows (原生)	⚠ 有限支持	手动安装

方法一：一键安装脚本（推荐）

适用于 Linux、macOS、WSL2 和 Android（Termux）的一键安装命令：

bash

curl -fsSL https://hermes.nousresearch.com/install.sh | bash

💡

安装脚本会自动检测系统环境，安装所有必要依赖（Python 3.11、Node.js v22 等），并完成初始化配置。

方法二：手动安装

如果一键脚本不适合你的环境，可以手动安装：

1. 安装 uv 包管理器

uv 是一个快速的 Python 包管理器：

bash

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装 Python 3.11+

bash

uv python install 3.11

3. 安装 Node.js v22

bash

# 使用 nvm 安装
nvm install 22
nvm use 22

# 或使用 fnm
fnm install 22
fnm use 22

4. 克隆并安装 Hermes Agent

bash

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv sync
npm install

安装后配置

安装完成后，你需要配置 LLM 提供商的 API 密钥：

配置文件位置

text

~/.hermes/
├── config.yaml      # 主配置文件
├── .env             # 环境变量（API 密钥等）
├── auth.json        # 认证配置
├── SOUL.md          # 代理身份定义
├── memories/        # 持久化记忆
├── skills/          # 已安装技能
├── cron/            # 定时任务
├── sessions/        # 会话数据
└── logs/            # 日志文件

设置 API 密钥

编辑 ~/.hermes/.env 文件，添加你的 API 密钥：

bash

# Nous Portal（推荐）
NOUS_API_KEY=your_nous_api_key_here

# OpenAI
OPENAI_API_KEY=your_openai_api_key_here

# Anthropic
ANTHROPIC_API_KEY=your_anthropic_api_key_here

# DeepSeek
DEEPSEEK_API_KEY=your_deepseek_api_key_here

验证安装

运行以下命令验证安装是否成功：

bash

hermes --version
hermes doctor

ⓘ

hermes doctor 命令会检查所有依赖项、配置文件和连接状态，帮助你快速诊断安装问题。

下一步

安装完成后，前往快速开始页面，了解如何运行你的第一个代理会话。