安装
使用这一行安装命令，不到两分钟即可让 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 wheel 构建自动导出
ANDROID_API_LEVEL - 通过
pip安装专门整理好的.[termux]extra - 默认跳过尚未验证的浏览器 / WhatsApp 引导流程
如果你想走完全显式的安装路径，请查看专门的 Termux guide。
Windows
原生 Windows 不受支持。请先安装 WSL2，然后在其中运行 Hermes Agent。上面的安装命令可直接在 WSL2 中使用。
安装器会做什么
安装器会自动处理全部工作：安装依赖（Python、Node.js、ripgrep、ffmpeg）、克隆仓库、创建虚拟环境、设置全局 hermes 命令，并引导你配置 LLM 大模型提供商（provider）。完成后你就可以直接开始聊天。
安装后
重新加载 shell，然后开始聊天：
source ~/.bashrc # or: source ~/.zshrc
hermes # Start chatting!
如果之后想单独调整某些配置，可使用这些命令：
hermes model # Choose your LLM provider and model
hermes tools # Configure which tools are enabled
hermes gateway setup # Set up messaging platforms
hermes config set # Set individual config values
hermes setup # Or run the full setup wizard to configure everything at once
前置要求
唯一的前置条件是 Git。其余内容安装器都会自动处理：
- uv（高速 Python 包管理器）
- Python 3.11（通过 uv 安装，无需 sudo）
- Node.js v22（用于浏览器自动化和 WhatsApp bridge）
- ripgrep（高速文件搜索）
- ffmpeg（用于 TTS 的音频格式转换）
信息
你不需要手动安装 Python、Node.js、ripgrep 或 ffmpeg。安装器会自动检测缺失项并帮你安装。只要确保系统里有 git 即可（git --version）。
Nix users
如果你在使用 Nix（无论是 NixOS、macOS 还是 Linux），项目还提供了专门的安装路径，包括 Nix flake、声明式 NixOS 模块以及可选的容器模式。详情见 Nix & NixOS Setup。
手动 / 开发者安装
如果你想克隆仓库并从源码安装，例如参与贡献、运行特定分支，或者完全掌控虚拟环境，请查看贡献指南中的 Development Setup。
故障排除
| Problem | Solution |
|---|---|
hermes: command not found | 重新加载 shell（source ~/.bashrc），或检查 PATH 是否正确 |
API key not set | 运行 hermes model 配置你的大模型提供商（provider），或执行 hermes config set OPENROUTER_API_KEY your_key |
| Missing config after update | 运行 hermes config check，然后执行 hermes config migrate |
如果需要更多诊断信息，请运行 hermes doctor。它会明确告诉你缺少什么，以及该如何修复。