安装

通过一行安装命令，在两分钟内启动并运行 Hermes Agent。

快速安装

Linux / macOS / WSL2

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

Android / Termux

Hermes 现在也提供了 Termux 感知的安装路径：

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

安装器会自动检测 Termux 并切换到经过测试的 Android 流程：

使用 Termux pkg 安装系统依赖（git、python、nodejs、ripgrep、ffmpeg、构建工具）
使用 python -m venv 创建虚拟环境
自动导出 ANDROID_API_LEVEL 用于 Android wheel 构建
使用 pip 安装精选的 .[termux] 额外组件
默认跳过未经测试的浏览器 / WhatsApp 引导

如果你想要完全显式的路径，请遵循专门的 Termux 指南。

Windows

原生 Windows 不受支持。请安装 WSL2 并在其中运行 Hermes Agent。上面的安装命令在 WSL2 内正常工作。

安装器做了什么

安装器自动处理所有事情 — 所有依赖（Python、Node.js、ripgrep、ffmpeg）、仓库克隆、虚拟环境、全局 hermes 命令设置和 LLM 提供商配置。完成后，你就可以开始聊天了。

安装后

重新加载 Shell 并开始聊天：

source ~/.bashrc   # 或：source ~/.zshrc
hermes             # 开始聊天！

以后要重新配置个别设置，使用专用命令：

hermes model          # 选择你的 LLM 提供商和模型
hermes tools          # 配置启用的工具
hermes gateway setup  # 设置消息平台
hermes config set     # 设置个别配置值
hermes setup          # 或运行完整设置向导一次配置所有内容

前提条件

唯一的前提是 Git。安装器自动处理其他所有内容：

uv（快速的 Python 包管理器）
Python 3.11（通过 uv 安装，无需 sudo）
Node.js v22（用于浏览器自动化和 WhatsApp 桥接）
ripgrep（快速文件搜索）
ffmpeg（用于 TTS 的音频格式转换）

信息

你不需要手动安装 Python、Node.js、ripgrep 或 ffmpeg。安装器会检测缺少什么并为你安装。只需确保 git 可用（git --version）。

Nix 用户

如果你使用 Nix（在 NixOS、macOS 或 Linux 上），有专门的设置路径，包括 Nix flake、声明式 NixOS 模块和可选容器模式。参见 Nix 和 NixOS 设置 指南。

手动 / 开发者安装

如果你想从源码克隆并安装 — 用于贡献代码、从特定分支运行或完全控制虚拟环境 — 请参见贡献指南中的开发设置部分。

故障排除

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

更多诊断，运行 hermes doctor — 它会准确告诉你缺少什么以及如何修复。

📝 本文由 AI 翻译，如有疑问请参考英文原版

快速安装​

Linux / macOS / WSL2​

Android / Termux​

安装器做了什么​

安装后​

前提条件​

手动 / 开发者安装​

故障排除​