先确认git已安装，再执行对应系统的一键安装命令；接着运行hermes setup配置模型提供商、api key和默认模型；最后用hermes chat -q "你好"验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地快速部署 Hermes Agent 并开始使用，但尚未完成基础安装与模型配置，则可能是由于系统环境未就绪或配置步骤遗漏。以下是完成 Hermes Agent 安装与基础配置的完整操作流程：
一、确认前置依赖
Hermes Agent 安装脚本会自动处理大部分运行时依赖，但前提是系统已具备 Git 工具。该工具用于拉取项目源码及管理更新。若缺失 Git，安装过程将中断并报错。
1、打开终端（Windows 用户需先启动 WSL2 中的 Ubuntu 终端；macOS/Linux 用户直接打开 Terminal）。
2、输入命令 git version 并回车。
3、若返回类似 git version 2.40.1 的版本信息，则 Git 已就绪；若提示 command not found，请先通过系统包管理器安装 Git。
二、选择安装方式并执行
根据操作系统类型与用户偏好，可选用以下任一方式完成核心程序安装。所有方式均不需手动安装 Python 或 Node.js，脚本将自动部署所需运行环境。
1、WSL2 / macOS / Linux 用户：在终端中执行一键安装命令：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。
2、纯 Windows（非 WSL）用户：以管理员身份打开 PowerShell，执行：irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | ie。
3、安装完成后，若提示命令未识别（如 hermes: command not found），需重载 Shell 配置：source ~/.bashrc（Bash 用户）或 source ~/.zshrc（Zsh 用户）。
三、启动交互式配置向导
安装仅完成运行环境搭建，Hermes Agent 本身不内置模型，必须通过配置向导接入外部大语言模型服务，否则无法响应任何对话请求。
1、在终端中输入命令：hermes setup。
2、按提示依次选择：模型提供商 → API Key 输入 → 默认模型名称 → 消息通道（如 Terminal）。
3、填写 API Key 时屏幕不显示字符，属安全设计，请确保粘贴准确；若中途出错，可随时中断并重新执行该命令。
四、验证模型连通性
配置完成后必须立即验证模型是否可调用，避免后续使用中出现空响应或超时错误。该步骤直接检测 Base URL、API Key 与模型名称三者组合的有效性。
1、执行测试命令：hermes chat -q "你好"。
2、若终端返回结构化 JSON 响应或自然语言回复（如“你好！我是 Hermes Agent”），表示模型链路已通。
3、若返回 Error: 401 Unauthorized，说明 API Key 错误或过期；若返回 Error: 404 Not Found，则 Base URL 地址填写有误。
五、手动编辑配置文件（备用方案）
当交互式向导因网络中断、终端兼容性或权限问题失败时，可跳过向导，直接修改 YAML 格式配置文件。此方式适用于熟悉文本编辑器操作的用户，且能精确控制每个字段值。
1、使用 nano 编辑器打开配置文件：nano ~/.hermes/config.yaml。
2、定位到 model: 区块，填入以下内容（示例为阿里云百炼）：
provider: custom
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
default: qwen-turbo
3、按 Ctrl+O 保存，再按 Ctrl+X 退出编辑器。
