新版发布:Hermes Agent v0.8.0 — 查看更新内容 →

安装 Hermes Agent

支持 Linux、macOS、WSL2 和 Android,2 分钟内即可运行。

在 Linux & macOS 上安装

在 Linux 或 macOS 上安装 Hermes Agent 最快的方式。安装程序会自动处理所有平台相关的配置。

# 下载并运行安装脚本
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 重新加载 shell 配置
source ~/.bashrc # or: source ~/.zshrc
# 启动 hermes
hermes

安装后的第一步

hermes setup

配置模型提供商和工具

hermes model

选择 LLM 提供商

hermes

开始你的第一次对话

使用 Docker 安装

在隔离的 Docker 容器中运行 Hermes Agent。适合需要干净环境隔离或部署到服务器的场景。

# 拉取并运行容器
docker run -it --rm \
-e OPENROUTER_API_KEY=your-key \
-v ~/.hermes:/root/.hermes \
nousresearch/hermes-agent:latest
Hermes 在容器内以非 root 用户运行。挂载卷和持久化存储的详细选项,请参阅官方文档中的 Docker 指南。

部署到 VPS 或云服务器

Hermes 可以在任何 Linux VPS 上运行。每月最低 $5 的服务器即可满足需求,包括消息网关功能。

最低配置要求

配置项最低要求推荐配置
CPU1 vCPU2 vCPU
内存512 MB1 GB
存储2 GB5 GB
操作系统Ubuntu 22.04Ubuntu 22.04 / Debian 12

安装并配置开机自启

# 安装 hermes(与 Linux 相同)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# 创建 systemd 服务实现开机自启
sudo tee /etc/systemd/system/hermes-gateway.service <<EOF
[Unit]
Description=Hermes Agent Gateway
After=network.target
[Service]
ExecStart=/usr/local/bin/hermes gateway start
Restart=always
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl enable --now hermes-gateway

在 Windows 上通过 WSL2 安装

Hermes Agent 不支持原生 Windows。推荐使用 WSL2(Windows Subsystem for Linux),它可以在 Windows 内提供完整的 Linux ��境。

第 1 步

安装 WSL2

以管理员身份打开 PowerShell 并运行:

wsl --install

出现提示时重启电脑。完整说明请访问 Microsoft WSL2 文档 ↗

第 2 步

在 WSL2 中安装 Hermes

打开 WSL2 终端(Ubuntu),运行标准安装命令:

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

在 Android 上安装(Termux)

Hermes Agent 通过 Termux 在 Android 上运行。使用 [termux] 附加包代替 [all],只安装 Termux 兼容的依赖。

# 在 Termux 中运行
pkg install python git
pip install hermes-agent[termux]
hermes
完整的 Termux 配置说明,请参阅 Hermes Agent 官方 Termux 使用指南 ↗

安装完成?开始配置你的 Agent 吧。