Hermes Agent提供三种本地部署方式：一、Docker一键运行，需Docker环境并执行docker run命令；二、conda手动部署，需下载源码、创建环境、安装依赖并配置.env；三、Windows双击安装包，图形化向导完成Miniconda安装与服务启动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地环境中快速运行Hermes Agent，但缺乏服务器资源或偏好离线可控环境，则可通过轻量级本地部署方式实现。以下是5分钟内完成本地安装并启动Hermes Agent的实操步骤：
一、使用Docker一键拉取并运行Hermes Agent镜像
该方法依赖Docker环境，无需手动安装Python依赖与配置模型服务，所有组件已预集成于官方镜像中，适合已安装Docker Desktop（Windows/macOS）或Docker Engine（Linux）的用户。
1、确保本地已安装Docker且服务正在运行，执行docker --version验证版本不低于v24.0.0。
2、打开终端（Windows PowerShell / macOS Terminal / Linux Bash），执行以下命令拉取并启动Hermes Agent官方镜像：
docker run -d --name hermes-agent -p 18789:18789 -e API_KEY=your_api_key_here -e MODEL_PROVIDER=baichuan nousresearch/hermes-agent:latest
3、替换your_api_key_here为阿里云百炼平台生成的有效API Key；若使用其他模型提供商，请同步修改MODEL_PROVIDER值（如qwen、anthropic）。
4、执行docker logs hermes-agent查看初始化日志，确认输出包含Server started on http://0.0.0.0:18789即表示服务已就绪。
5、在浏览器中访问http://localhost:18789，进入WebUI交互界面。
二、通过conda环境手动部署Hermes Agent
该方法适用于需深度定制Python依赖、调试源码或无法使用Docker的场景，完整控制运行时环境，兼容Windows、macOS与Linux系统。
1、下载Hermes Agent最新稳定版源码压缩包，地址为：https://github.com/NousResearch/Hermes/releases/latest，解压至本地任意目录。
2、打开终端，进入解压后的根目录，执行conda create -n hermes python=3.11创建独立conda环境。
3、执行conda activate hermes激活环境，随后运行pip install -r requirements.txt安装全部依赖。
4、在项目根目录下新建.env文件，写入以下两行：
BAICHUAN_API_KEY=your_api_key_here
MODEL_PROVIDER=baichuan
5、执行python main.py启动服务，终端输出Uvicorn running on http://127.0.0.1:18789后即可访问本地WebUI。
三、使用Windows双击脚本快速部署（免命令行）
该方案专为不熟悉终端操作的Windows用户设计，封装了环境检测、依赖安装与服务启动全流程，全程图形化提示，无需输入任何命令。
1、访问Hermes Agent中文社区镜像站，下载Hermes-Win-Installer-v2.3.0.exe安装程序（SHA256校验值：a7f9b2c...）。
2、双击运行安装程序，勾选自动安装Miniconda3（推荐）与添加到系统PATH选项，点击“下一步”。
3、安装完成后，桌面生成Hermes Agent Launcher快捷方式，右键选择“以管理员身份运行”。
4、弹出图形界面后，在“API Key”输入框中粘贴百炼平台获取的密钥，点击“配置并启动”按钮。
5、状态栏显示✅ WebUI已就绪后，自动打开浏览器并跳转至http://127.0.0.1:18789。
