60 秒完成安装
安装 Hermes Agent
一键脚本安装，支持 Linux、macOS、WSL2 和 Android Termux。安装后立即可以开始对话。
前置条件
terminal
Python ≥ 3.10
Hermes 是 Python 项目。运行 python3 --version 检查版本。
wifi
网络连接
安装脚本从 GitHub 下载。国内用户可能需要代理。
computer
支持的平台
Linux、macOS、WSL2。Windows 原生不支持，请用 WSL2。
1
执行一键安装脚本
打开终端，执行官方安装脚本。脚本会自动检测系统环境，安装 Hermes 运行时及其依赖。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash macOS 自带 curl，直接粘贴执行即可。如遇权限问题，先运行 xcode-select --install。
✓ Hermes installed successfully
Run `hermes` to start chatting
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 支持 Ubuntu 20.04+、Debian 11+、CentOS 8+、Arch 等。部分发行版需先 sudo apt install curl。
✓ Hermes installed successfully
Run `hermes` to start chatting
# 先确保 WSL2 已安装（PowerShell 管理员模式）
wsl --install # 进入 WSL 后执行安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Windows 原生不支持，必须在 WSL2 环境中运行。推荐 Ubuntu 22.04 LTS。
✓ Hermes installed successfully
Run `hermes` to start chatting
# 先安装依赖
pkg install curl python curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Android Termux 需先安装 curl 和 Python。部分机型需关闭电池优化以防后台被杀。
✓ Hermes installed successfully
Run `hermes` to start chatting
2
运行配置向导
首次使用需要配置模型 provider 和 API key。运行交互式向导完成全部配置。
hermes setup
3
常见问题
安装脚本报错怎么办？ expand_more
检查网络是否能访问 GitHub。如不能，尝试
pip install hermes-agent 直接安装。Python 版本需 ≥ 3.10。
如何卸载 Hermes Agent？ expand_more
执行
hermes uninstall 即可完整清理。配置文件保留在 ~/.hermes/，可手动删除。
支持哪些操作系统？ expand_more
Linux、macOS、Windows WSL2、Android Termux。Windows 原生不支持。