可直接使用官方一键安装脚本快速部署Hermes Agent：macOS/Linux/WSL2执行curl命令；Windows需管理员PowerShell运行irm命令；调试时加-bash -x；最后用hermes --version和hermes chat验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地快速部署 Hermes Agent，但被繁琐的环境配置和依赖安装所困扰，则可直接使用官方提供的一键安装脚本。以下是基于不同操作系统的全流程执行步骤：
一、macOS 与 Linux（含 WSL2）一键安装
该方法适用于 macOS、原生 Linux 及 Windows 上的 WSL2（Ubuntu 推荐），脚本会自动检测并安装 Python、Node.js、Git、ripgrep 等全部必要依赖，无需手动干预。
1、打开 Terminal（macOS/Linux）或 PowerShell（以管理员身份运行后进入 WSL2 Ubuntu）。
2、执行以下命令：
curl -fsSL https://hermes-agent.org/install.sh | bash
3、等待脚本自动完成下载、依赖安装与初始化，全程约 2–3 分钟。
4、安装结束后，系统将提示您运行 hermes init 进入交互式配置向导。
二、Windows 原生 PowerShell 安装（需管理员权限）
此方式专为 Windows 用户设计，脚本会自动拉取并执行 Windows 兼容版本的安装流程，包括检测并安装 Python、Node.js、Git、ripgrep 等组件。
1、在 Windows 开始菜单中搜索“PowerShell”，右键选择“以管理员身份运行”。
2、执行以下命令：
irm https://raw.githubusercontent.com/nousresearch/hermes-agent/main/scripts/install.ps1 | iex
3、脚本启动后将自动检查当前环境，缺失依赖时静默安装，不弹出交互式提示。
4、安装完成后，终端将显示“Installation completed”，此时可立即执行 hermes setup 开始配置。
三、带调试信息的安装（排查失败原因）
当标准安装因网络或权限问题中断时，启用详细日志输出有助于定位具体失败环节，例如 pip 超时、Python 版本不匹配等。
1、在 Terminal 或 WSL2 Ubuntu 中执行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -x
2、观察每行命令的执行结果，重点关注以 “+” 开头的调试输出行。
3、若卡在某一步（如 pip install），可单独复制该行命令，在终端中追加国内镜像源重试：
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
四、验证安装是否成功
无论采用哪种安装方式，最终都需确认 Hermes Agent 的核心命令可正常调用，且能连接模型服务。
1、执行版本检查命令：
hermes --version
2、运行基础对话测试：
hermes chat "你好"
3、若返回有效响应（非报错信息），说明安装与基础运行环境已就绪。
