新手安装Hermes Agent v0.19.0必须严格按环境适配路径操作：Windows用户优先用管理员PowerShell执行国内镜像脚本，旧系统或企业版改用WSL2+Ubuntu 22.04，Mac/Linux统一走curl脚本；安装后必须运行hermes setup完成初始化配置，否则启动报“No model configured”错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
新手安装 Hermes Agent v0.19.0 时，常因网络卡在 GitHub 克隆、PowerShell 权限不足、模型配置跳过导致启动后报错“No model configured”而失败，必须严格按环境适配路径操作，不能直接复制网上过期命令。
确认系统与安装路径
Windows 用户优先用 PowerShell 管理员模式执行脚本；若系统是 Windows 10 2004 以前版本、或企业版禁用脚本策略，改用 WSL2 + Ubuntu 22.04；Mac 和 Linux 用户统一走终端 curl 脚本路径。这一步跳过会导致后续所有依赖安装失败，且错误提示不指向根源。
检查当前 PowerShell 是否为管理员：右键开始菜单 → Windows Terminal（管理员），看到提示符前有【管理员】字样才算达标。
Windows 原生安装（推荐国内镜像）
方法一：国内用户直接运行（避 GitHub 卡死）
在管理员 PowerShell 中逐行执行：
irm https://res1.hermesagent.org.cn/install.ps1 | iex
方法二：国际源备用（仅当国内镜像失效时用）
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
【注意：必须用 irm（Invoke-RestMethod），不能用 curl 或 wget，否则脚本无法执行】
等待终端输出 Installation completed successfully 后，关闭并重新打开一个全新 PowerShell 窗口——旧窗口的环境变量未刷新，hermes 命令会提示“找不到命令”。
WSL2 + Ubuntu 安装（绕过 Windows 权限限制）
第一步：启用 WSL2 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart → dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart → 重启电脑
第二步：设置默认版本并安装 Ubuntu
wsl --set-default-version 2 → 在 Microsoft Store 安装 Ubuntu 22.04 LTS → 首次启动时设用户名密码
第三步：在 Ubuntu 终端中执行安装
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
安装完成后，输入 hermes --version，必须返回 Hermes Agent v0.19.0 才算通过基础验证。若报错 command not found，说明脚本未自动写入 PATH，需手动执行 source ~/.bashrc。
安装后必做的初始化配置
无论哪种安装方式，都必须立即运行：
hermes setup
选择 Quick Setup → 按提示输入 Y 确认全部默认路径 → 等待生成 ~/.hermes/config.yaml
这一步跳过，hermes 启动时会直接崩溃并报错 No model provider configured，且不会给出修复指引。配置文件生成后，可手动检查该文件是否存在、是否为空——空文件说明向导中途被中断，需重跑 setup。
国产用户推荐在此步骤中选 Kimi 或 智谱AI，填入 API Key 后会自动测试连通性，失败则立刻提示，不进入下一步。
