首次部署Hermes Agent需按五步标准化流程：一、选平台并准备环境（阿里云/ECS、腾讯云/4核4G Ubuntu 22.04或本地Win+WSL）；二、执行对应平台一键安装命令；三、运行hermes setup完成模型提供商、API Key及通信通道配置；四、用hermes doctor验证模型连通性、运行环境与技能模块；五、输入hermes启动交互终端，测试指令确认响应正常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您是首次接触 Hermes Agent，希望在本地或云端快速完成基础部署并启动首个智能体实例，则需按标准化流程完成环境准备、服务安装与初始配置。以下是实现这一目标的步骤：
一、选择部署平台并准备环境
根据硬件条件与使用偏好，可选用云端服务器或本地 Windows 系统作为运行载体；不同平台对依赖组件和权限要求存在差异，需提前确认系统兼容性与必要权限。
1、若选择阿里云 ECS：确保账号已完成实名认证，并具备创建 ECS 实例的权限。
2、若选择腾讯云轻量应用服务器：推荐配置为 4核4G，操作系统选用 Ubuntu 22.04 LTS。
3、若选择本地 Windows 系统：需以管理员身份运行 PowerShell，且系统已启用 Windows Subsystem for Linux（WSL）或具备完整网络访问能力。
二、执行一键式安装命令
Hermes Agent 提供跨平台自动化安装脚本，可统一处理 Python、Git、Node.js 等底层依赖，避免手动逐项安装引发的版本冲突问题。
1、在 Windows 环境中打开 PowerShell（管理员模式），执行以下命令：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
2、在 Ubuntu 环境中打开终端，执行以下命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
3、等待脚本自动下载、校验并安装全部依赖组件，过程通常耗时 60–120 秒。
三、启动交互式配置向导
安装完成后，系统将自动触发 setup 向导，引导用户完成模型提供商、API Key 及基础通信通道的绑定，所有选项均支持键盘方向键选择与回车确认。
1、在终端中输入 hermes setup 并回车，进入配置流程。
2、使用方向键选择 Quick setup — provider, model & messaging (recommended)，按回车确认。
3、在模型提供商列表中，若未直接显示所需服务商（如 Z.AI 或 Kimi），选择 More providers 后继续筛选并粘贴对应 API Key。
4、Base URL 字段若无自定义需求则直接回车跳过，模型名称处输入 glm-5.1 或其他已授权模型标识符。
四、验证部署状态与基础功能
配置完成后需立即验证核心服务是否正常加载，包括模型连通性、本地运行时环境及默认技能模块的可用性，避免后续交互失败。
1、执行诊断命令检查整体健康状况：
hermes doctor
2、观察输出中 Model connectivity: OK、Runtime environment: Ready、Skills registry: Loaded 12/12 等关键状态项是否全部显示为成功标识。
3、若某一项标为 FAILED 或 MISSING，记录具体模块名称，不执行下一步操作。
五、启动首次对话会话
当诊断结果全部通过后，即可启动 Hermes Agent 的默认交互终端，该终端将加载持久化记忆模块与基础工具集，形成首个可响应指令的智能体实例。
1、在终端中输入以下命令启动交互界面：
hermes
2、等待约 3–5 秒，界面出现绿色欢迎横幅及提示符 >。
3、输入测试指令，例如：Hello, what is your name and version?，观察是否返回包含 Hermes Agent v0.12.3 及角色声明的结构化响应。
