docker 方式部署是首选方案，适用于全平台且环境隔离；需先验证 docker 服务、拉取国内加速镜像、创建挂载目录、运行容器并访问 http://localhost:8000。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地设备上运行 Hermes Agent，但尚未完成环境搭建或部署流程，则可能是由于缺少必要依赖、镜像拉取失败或配置路径错误。以下是解决此问题的步骤：
一、Docker 方式部署
该方式适用于 Windows、macOS 和 Linux 系统，通过容器化隔离运行环境，避免依赖冲突，且支持快速启停与数据持久化。
1、确认系统已安装 Docker 或 Docker Desktop，并执行 docker version 验证服务正常运行。
2、执行命令拉取国内加速镜像：docker pull docker.xuanyuan.run/nousresearch/hermes-agent:latest。
3、创建本地数据目录用于挂载：mkdir -p ~/.hermes（Linux/macOS）或在 PowerShell 中执行 mkdir C:\Users\用户名\hermes（Windows）。
4、运行容器并挂载目录与端口：docker run -d --name hermes -p 8000:8000 -v ~/.hermes:/root/.hermes nousresearch/hermes-agent:latest。
5、访问 http://localhost:8000 查看 WebUI 界面（部分功能需 CLI 交互）。
二、源码方式部署（Linux/macOS/WSL）
该方式适合需要二次开发、调试或自定义模型集成的用户，完整控制项目结构与运行时行为。
1、执行官方一键安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
2、或手动克隆仓库：git clone https://github.com/NousResearch/hermes-agent.git。
3、进入项目目录后运行初始化脚本：cd hermes-agent && ./setup-hermes.sh。
4、激活虚拟环境并启动服务：source .venv/bin/activate && python -m hermes。
三、Windows 原生部署（PowerShell）
该方式无需 WSL 或虚拟机，直接在 Windows 环境中安装全部依赖并运行，适配新手用户快速上手。
1、以管理员身份打开 PowerShell，执行安装命令：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex。
2、脚本将自动安装 Python、Node.js、Git、ripgrep 等必需组件。
3、安装完成后进入 Quick setup 流程，按提示输入 Y 确认各项配置。
4、启动成功后，终端将显示欢迎界面及默认监听地址 http://127.0.0.1:8000。
四、Home 目录标准化初始化
无论采用何种部署方式，Hermes Agent 均默认读取 ~/.hermes 下的配置与会话数据，统一初始化可避免路径异常导致的功能缺失。
1、在用户主目录下创建隐藏配置文件夹：mkdir ~/.hermes。
2、设置 Python 包索引为阿里云镜像：export UV_INDEX_URL="https://mirrors.aliyun.com/pypi/simple"。
3、设置 npm 镜像源：export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com。
4、设置 Playwright 下载主机：export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright。
五、NAS 设备部署（ARM 架构适配）
适用于飞牛 NAS、群晖、威联通等搭载 ARM 处理器的网络存储设备，利用其 24 小时在线特性实现常驻 AI 服务。
1、通过 SSH 登录 NAS 终端，确认 Docker 服务已启用。
2、执行镜像拉取命令（使用 ARM 兼容镜像）：docker pull docker.xuanyuan.run/nousresearch/hermes-agent:arm64-latest。
3、创建挂载目录：mkdir -p /volume1/docker/hermes（以群晖为例，路径依实际存储卷调整）。
4、运行容器并指定 ARM 平台架构：docker run -d --platform linux/arm64 --name hermes -p 8000:8000 -v /volume1/docker/hermes:/root/.hermes docker.xuanyuan.run/nousresearch/hermes-agent:arm64-latest。
