安装指南
通过一行命令安装程序，在两分钟内让 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 指南。
:::warning Windows 原生 Windows 不受支持。请先安装 WSL2，然后在 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`）。
:::tip Nix 用户 如果你使用 Nix（在 NixOS、macOS 或 Linux 上），有专门的设置路径，包括 Nix flake、声明式 NixOS 模块和可选容器模式。请参阅 Nix & NixOS 设置 指南。