需先确认系统兼容性与前置条件，再执行一键安装脚本，完成初始配置后修复模型识别问题，并手动安装飞书网关依赖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在个人电脑上部署 Hermes Agent，但遇到依赖缺失、环境冲突或配置失败等问题，则可能是由于系统环境未满足运行要求或安装流程不完整。以下是完成本地部署的具体操作步骤：
一、确认系统兼容性与前置条件
Windows 原生环境不被官方推荐，但可通过 PowerShell 管理员模式配合自动脚本实现部署；Linux/macOS/WSL2 是更稳定的选择。部署前需确保基础工具已就位，否则后续步骤将中断。
1、打开终端（PowerShell 或 WSL2 中的 bash），执行 git --version 验证 Git 是否可用。
2、执行 python --version 检查 Python 是否为 3.10–3.12 版本范围。
3、执行 node --version 确认 Node.js 已安装且版本不低于 18.x。
4、若任一命令报错，需先手动安装对应组件，再继续后续流程。
二、一键安装 Hermes Agent 主体环境
该步骤通过官方 install.ps1 脚本自动拉取并配置全部运行依赖，包括 Python 包、Node.js 模块及系统级工具，避免手动逐项安装引发的路径或版本冲突。
1、以管理员身份启动 PowerShell。
2、执行以下命令：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。
3、等待脚本输出 Installation completed successfully 提示，期间勿关闭窗口。
4、安装完成后，终端将自动进入初始配置向导。
三、完成初始配置与模型绑定
配置向导用于生成基础运行参数，其中模型供应商设置直接影响后续推理能力是否可用；跳过飞书等消息平台选项是必要操作，因需单独通过 Gateway 模块接入。
1、在向导中选择 Quick setup 选项。
2、在模型供应商列表中，选择您已获取 API Key 的服务商（如 DashScope、OpenRouter 或 Kimi）。
3、当提示选择消息平台时，直接按回车跳过（飞书不在默认列表中）。
4、对后续自动化配置项统一输入 Y 确认。
5、看到欢迎界面及 Hermes is ready! 字样，表示主体配置完成。
四、修复模型未识别问题
Windows 下常见模型名称显示为空或报错“no model found”，本质是环境变量未正确注入至 Hermes 内置虚拟环境中，需通过交互命令强制指定模型标识符。
1、在已启动的 Hermes 会话中，输入命令：/model。
2、根据提示输入目标模型全名，例如：dashscope/qwen-max 或 openrouter/anthropic/claude-3-haiku。
3、再次执行 /model 查看当前模型状态，确认返回值中包含已输入的模型名称。
4、若仍为空，检查对应服务商的 API Key 是否已正确写入 .env 文件且无多余空格。
五、手动安装飞书网关依赖（Windows 必做）
Hermes Gateway 在 Windows 上运行时默认缺少 lark-oapi SDK，导致飞书连接初始化失败；该依赖必须安装到 Hermes 自带的 venv 中，而非全局 Python 环境。
1、新开一个 PowerShell 窗口，切换至 Hermes 安装目录（通常为 C:\Users\{用户名}\AppData\Local\hermes-agent\venv）。
2、执行：.\Scripts\pip.exe install lark-oapi。
3、验证安装结果：运行 .\Scripts\python.exe -c "import lark_oapi; print('OK')"，输出 OK 即成功。
4、返回原 Hermes 终端，重新执行 hermes gateway setup 启动配置流程。
