官方一键安装脚本是最快部署hermes agent的方式，支持macos、linux及wsl2下的windows；执行curl -fssl脚本命令即可自动完成依赖安装、环境配置与核心组件部署，并提供powershell版、国内镜像源和调试模式等适配选项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望快速部署 Hermes Agent，官方提供的一键安装脚本是最直接高效的方式。该脚本自动完成依赖检测、环境配置与核心组件安装，适用于 macOS、Linux 及 WSL2 环境下的 Windows 用户。以下是该脚本的详细使用说明与适配要点：
一、Linux/macOS 一键安装（bash 脚本）
该方式使用 curl 下载并执行官方 install.sh 脚本，全程自动化处理 Python、Node.js、Git、ripgrep 等基础依赖，无需手动干预。
1、打开终端（Terminal 或 iTerm），确保已安装 curl 和 bash。
2、执行以下命令启动安装流程：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
3、等待终端输出 Installation completed successfully 提示，表示核心程序已就位。
4、为使新安装的命令生效，需重新加载 shell 配置：
source ~/.bashrc（Bash 用户）
source ~/.zshrc（Zsh 用户）
5、运行 hermes --version 验证 CLI 是否可用。
二、Windows PowerShell 一键安装（PowerShell 脚本）
Windows 用户不可直接运行 bash 脚本，须通过 PowerShell 执行 install.ps1。该脚本内置依赖自检逻辑，可自动安装 Python、Node.js、Git、ripgrep 等全部必要组件。
1、以管理员身份运行 PowerShell（右键开始菜单 → Windows PowerShell（管理员））。
2、执行以下命令启用远程脚本执行策略（首次需运行）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3、执行官方安装命令：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
4、观察终端输出中是否出现 Installing dependencies... 及后续成功提示。
5、安装完成后，PowerShell 将自动启动配置向导；若未触发，可手动运行 hermes setup。
三、替代镜像源安装（国内网络优化）
在无法访问 GitHub Raw 的网络环境下，官方提供备用安装入口，使用国内镜像加速下载，避免超时中断。
1、在终端中执行以下命令（Linux/macOS）：
curl -fsSL https://get.hermes.chat | bash
2、该地址由 Hermes 官方维护，内容与 GitHub 主干完全一致，且支持 HTTPS 证书自动校验。
3、执行后终端将显示 Downloading installer from mirror...，确认来源可信。
4、安装日志中若出现 Using mirror: https://get.hermes.chat，表明已切换至国内通道。
四、调试模式安装（排查问题专用）
当安装过程静默失败或卡在某一步时，可通过启用调试模式查看每条命令的实际执行路径与返回值。
1、在 Linux/macOS 终端中执行带 -x 参数的安装命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -x
2、终端将逐行打印脚本内部指令，包括依赖检测结果、下载 URL、安装路径等关键信息。
3、若报错出现在 pip install 步骤，可立即识别是否因网络导致超时。
4、如发现 rg not found 或 python3.12 required 类提示，对应查阅避坑指南中专项修复方案。
五、验证安装完整性（必做步骤）
脚本执行完毕不等于 Agent 可用，必须通过标准命令验证各子系统是否正常初始化。
1、运行 hermes doctor 启动健康检查，该命令会扫描模型后端、浏览器驱动、配置文件等 7 项核心模块。
2、检查输出中是否存在 ✅ All checks passed 标识；若出现 ❌，其后紧跟具体缺失项（如 CAMOFOX_URL not set）。
3、手动测试基础对话能力：
hermes chat "你好"
4、若收到结构化 JSON 响应或文本回复，且无 ModuleNotFoundError 报错，则 CLI 层安装确认成功。
