安装 Hermes Agent — Hermes Agent Lab

安装步骤详解

Step 01

打开终端，粘贴下面的一行命令。安装脚本会自动检测您的操作系统并处理一切。

# macOS / Linux / WSL2

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

# Windows (PowerShell)

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Step 02

安装完成后，选择您的 LLM 供应商。支持 Nous Portal（OAuth）、OpenRouter、OpenAI、Anthropic、Gemini 或自定义端点。

# Choose your LLM provider interactively

hermes model

# Or use Nous Portal (OAuth, no API key needed)

hermes setup --portal

Step 03

设置消息网关，从 Telegram、Discord、Slack、WhatsApp 或 Signal 访问您的代理——全部通过统一进程。

# Interactive gateway setup wizard

hermes gateway setup

# Start the messaging gateway

hermes gateway

Step 04

在终端输入 hermes，开始您的第一次对话。代理立即开始学习——构建记忆和创建技能。

# Reload your shell first, then:

source ~/.bashrc # or: source ~/.zshrchermes

非 Windows 平台仅需 Git。Linux 还需确保 curl 和 xz-utils 可用。安装脚本会自动处理其他一切。

自动安装的依赖：

uv（Python 包管理器）、Python 3.11、Node.js v22、ripgrep（快速文件搜索）、ffmpeg（音频转换）

安装后文件的存放位置：

安装方式	代码位置	可执行文件	数据目录
普通用户 (git)	~/.hermes/hermes-agent/	~/.local/bin/hermes	~/.hermes/
Root (sudo)	/usr/local/lib/hermes-agent/	/usr/local/bin/hermes	/root/.hermes/

一个订阅即可使用 300+ 模型和 Tool Gateway（网页搜索、图片生成、TTS、云端浏览器）。运行 hermes setup --portal 一键完成 OAuth 登录 + 供应商设置 + Tool Gateway 激活。

hermes setup --portal

重新加载 Shell 并开始对话

source ~/.bashrc # or: source ~/.zshrchermes # Start chatting!

问题	解决方案
hermes: command not found	重新加载 Shell（source ~/.bashrc 或 source ~/.zshrc），或检查 PATH。
API key not set	运行 hermes model 配置供应商，或 hermes config set PROVIDER_API_KEY your_key。
更新后配置丢失	运行 hermes config check 然后 hermes config migrate。