windows/macos双平台一键安装hermes agent：windows用powershell执行install.ps1脚本自动装依赖，或用wsl2+ubuntu运行install.sh；mac用homebrew补全依赖后运行install.sh；模型未识别时输入/model手动绑定；windows飞书网关缺lark-oapi需uv pip安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 Mac 或 Windows 系统上快速部署 Hermes Agent，但遇到依赖缺失、权限报错或飞书网关启动失败等问题，则很可能是安装路径或环境隔离未正确处理。以下是覆盖双平台的零基础安装操作步骤：
一、Windows 系统一键安装（PowerShell 方式）
该方法通过官方提供的 install.ps1 脚本自动拉取并配置全部运行时依赖，适用于绝大多数 Windows 10/11 环境，无需手动安装 Python 或 Node.js。
1、以管理员身份打开 PowerShell。
2、执行以下命令：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。
3、脚本将自动检测并安装 Python、Node.js、Git、ripgrep 等必要组件，等待终端输出 Installation completed successfully 提示。
4、安装完成后，直接在 PowerShell 中输入 hermes 启动配置向导。
二、Windows 系统一键安装（WSL2 + Ubuntu 方式）
当 PowerShell 安装因系统策略或网络限制失败时，可借助 WSL2 构建类 Linux 运行环境，规避 Windows 原生 Python 包管理冲突与权限问题。
1、以管理员身份运行 PowerShell，执行：dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart。
2、继续执行：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart，随后重启电脑。
3、重启后，在普通 PowerShell 中运行：wsl --set-default-version 2。
4、前往 Microsoft Store 安装 Ubuntu 22.04 LTS，首次启动时设置 Linux 用户名与密码。
5、在 Ubuntu 终端中依次执行：curl -sS https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
三、Mac 系统一键安装（Homebrew + Shell 方式）
Mac 平台默认具备较新版本的 Python 和 Git，但需确保 Homebrew 已就绪并使用 zsh 作为默认 shell，避免因 Shell 初始化脚本未加载导致命令不可用。
1、打开 Terminal，执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 安装 Homebrew。
2、执行：brew install python git node npm ripgrep 补全核心依赖。
3、运行安装脚本：curl -sS https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
4、安装完毕后，执行：source ~/.zshrc && hermes 启动配置向导。
四、模型未识别问题修复（跨平台通用）
Hermes Agent 启动后若显示模型为空或报错“no model found”，说明模型注册未生效，常见于 Windows venv 隔离或 Mac Rosetta 兼容场景，需手动触发模型绑定。
1、在 Hermes 交互界面中输入命令：/model。
2、根据提示选择可用模型供应商（如 Kimi、Ollama、OpenRouter 等）。
3、输入对应模型标识符，例如：kimi/kimi-plus 或 ollama/llama3。
4、确认返回信息中模型名称与版本号正常显示，即表示绑定成功。
五、飞书网关依赖缺失修复（Windows 专属）
在 Windows 上执行 hermes gateway setup 并选择飞书后，启动网关时若报错 ModuleNotFoundError: No module named 'lark-oapi'，说明内置虚拟环境中缺少飞书 SDK。
1、在 PowerShell 中执行：Get-Command hermes | Select-Object -ExpandProperty Source 获取可执行文件路径。
2、根据路径推导出 venv 目录，典型路径为：C:\Users\{用户名}\AppData\Local\hermes\hermes-agent\venv\Scripts\。
3、执行 uv pip 安装命令：uv pip install lark-oapi --python "C:\Users\{用户名}\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe"。
4、安装完成后，再次运行：hermes gateway start 验证网关是否正常加载飞书渠道。
