推荐使用wsl2+ubuntu部署：启用wsl与虚拟机平台→重启→设置wsl2为默认→安装ubuntu 22.04→初始化用户→运行官方安装脚本→执行source ~/.bashrc && hermes启动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地快速搭建 Hermes Agent 开发环境，但尚未完成基础依赖与运行平台配置，则可能是由于 Windows 原生环境不直接支持其核心运行时要求。以下是实现本地部署的多种可行路径：
一、通过 WSL2 + Ubuntu 部署（推荐主流方案）
该方法利用 Windows 子系统 Linux 模拟原生 Linux 环境，完全兼容 Hermes Agent 官方安装脚本与依赖链，是当前最稳定、社区支持最完善的部署方式。
1、以管理员身份打开 PowerShell，执行命令启用 WSL 和虚拟机平台功能：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
2、重启计算机，确保虚拟化功能生效。
3、重启后，在普通用户权限的 PowerShell 中运行：
wsl --set-default-version 2
4、打开 Microsoft Store，搜索并安装 Ubuntu 22.04 LTS（或最新 LTS 版本）。
5、首次启动 Ubuntu，按提示创建 Linux 用户名与密码，并完成初始化。
6、在 Ubuntu 终端中执行官方一键安装命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
7、安装完成后运行：
source ~/.bashrc && hermes
二、使用 Windows 原生 PowerShell 直接部署（轻量适配方案）
该路径绕过 WSL，依赖 Hermes Agent 提供的 Windows 专用适配分支，适用于仅需调用外部大模型 API、不运行本地模型的轻量开发场景。
1、访问第三方开发者提供的 GitHub 仓库，复制专属安装代码（通常为 PowerShell 脚本或 .ps1 文件）。
2、以管理员身份打开 Windows PowerShell，粘贴并执行安装代码。
3、等待安装程序自动完成 Python 环境、依赖包及 CLI 工具链部署。
4、验证安装结果：
hermes-vision —— 若返回版本号即表示核心 CLI 已就绪。
5、若出现旧进程残留报错，关闭当前窗口，新建 PowerShell 窗口重试验证命令。
6、运行配置向导：
hermes-setup —— 按提示选择是否导入已有 OpenInterpreter 配置，或手动配置 LLM 提供商。
三、离线手动部署（网络受限环境专用）
当目标机器无法连接公网时，可预先在联网设备下载全部资源，再通过本地文件传输完成部署，避免安装脚本因网络中断失败。
1、在可联网设备上执行：
git clone https://github.com/NousResearch/hermes-agent.git
2、将整个 hermes-agent 文件夹复制至目标 Windows 机器（如 D:\hermes-agent）。
3、在目标机器 PowerShell 中进入该目录：
cd D:\hermes-agent
4、运行依赖安装命令：
pip install -r requirements.txt
5、确认 Python 3.11+ 已安装且加入系统 PATH；若未安装，请先从 python.org 下载并勾选 “Add Python to PATH”。
6、执行启动命令：
python -m hermes
