安装 Hermes Agent

Hermes Agent 的默认安装方式是一行脚本。它会自动处理依赖、克隆仓库、创建虚拟环境、注册全局 hermes 命令，并进入模型供应商配置流程。第一次安装前只需要确认本机已有 git。

一行安装

Linux、macOS、WSL2 和 Android Termux 都使用同一条命令：

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

Windows 不支持原生运行，官方建议先安装 WSL2，然后在 WSL2 终端里执行上面的命令。Termux 会被安装器自动识别，并走 Android 专用流程：使用 pkg 安装系统依赖、用 python -m venv 创建环境、设置 ANDROID_API_LEVEL，并默认跳过未充分测试的浏览器和 WhatsApp 启动步骤。

安装器会做什么

安装器会自动补齐常见运行依赖：

• uv：Python 包管理器
• Python 3.11：由 uv 管理，不需要系统级 sudo 安装
• Node.js v22：用于浏览器自动化和 WhatsApp bridge
• ripgrep：文件搜索
• ffmpeg：语音和音频格式转换

普通用户安装时，代码会放在 ~/.hermes/hermes-agent/，全局命令是 ~/.local/bin/hermes 的 symlink，数据目录是 ~/.hermes/。如果用 root 模式安装，代码会进入 /usr/local/lib/hermes-agent/，命令放在 /usr/local/bin/hermes，数据默认在 /root/.hermes/ 或显式的 $HERMES_HOME。

安装后第一步

安装完成后重载 shell，再启动 Hermes：

source ~/.bashrc
hermes

如果你使用 zsh：

source ~/.zshrc
hermes

后续配置建议走 Hermes 自带命令，不要手改多个文件：

hermes model
hermes tools
hermes gateway setup
hermes config set
hermes setup

常见问题

• hermes: command not found：先重载 shell；仍失败时检查 ~/.local/bin 是否在 PATH 里。
• API key not set：运行 hermes model 重新选择 provider，或用 hermes config set 写入对应 key。
• 升级后配置缺失：先跑 hermes config check，再跑 hermes config migrate。

更细的环境诊断直接跑：

hermes doctor

开发者如果要从源码安装、切特定分支或贡献代码，再看官方的 Contributing / Development Setup；普通用户不需要走手动安装路径。