需安装Python≥3.10与Node.js≥18.x，克隆源码并配置虚拟环境与前端依赖，设置模型API凭证于.env文件，启动后端与前端服务，最后启用调试日志及技能热重载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在本地机器上搭建 Hermes Agent 开发环境，以便进行代码调试、技能开发或模型适配验证，则需满足运行依赖与开发工具链的完整配置。以下是完成本地开发环境配置的具体操作路径：
一、安装 Python 与 Node.js 运行时
本地开发依赖 Python（≥3.10）和 Node.js（≥18.x）共同支撑 Hermes Agent 的核心执行与前端交互模块。缺失任一运行时将导致初始化失败或 CLI 功能不可用。
1、访问 https://www.python.org/downloads/ 下载并安装 Python 3.10 或更高版本，安装时勾选 “Add Python to PATH” 选项。
2、访问 https://nodejs.org/ 下载 LTS 版本（v18.x 或更新），安装过程自动配置 npm 和 node 命令环境。
3、打开终端（Windows 使用 PowerShell，macOS/Linux 使用 Bash/Zsh），依次执行以下命令验证安装：
python --version
node --version
npm --version
二、克隆源码并安装核心依赖
Hermes Agent 官方仓库提供完整可构建源码，本地开发必须基于源码目录执行依赖安装与环境初始化，避免使用预编译包导致调试信息缺失。
1、确保已安装 Git，执行命令克隆官方仓库：
git clone https://github.com/NousResearch/hermes-agent.git
2、进入项目根目录：
cd hermes-agent
3、安装 Python 依赖（推荐使用虚拟环境）：
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
4、安装 Node.js 前端依赖：
cd frontend
npm install
cd ..
三、配置模型接入凭证
本地开发需明确指定大模型后端，Hermes Agent 支持通过环境变量注入 API Key 与 Endpoint，确保调用链路直连且不经过中间代理。
1、在项目根目录创建 .env 文件，写入如下内容（以阿里云百炼为例）：
HERMES_MODEL_PROVIDER=custom
HERMES_CUSTOM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
HERMES_CUSTOM_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
HERMES_CUSTOM_MODEL_NAME=qwen-max
2、若使用其他模型服务（如 Ollama、OpenAI 兼容接口），需同步替换 BASE_URL、API_KEY 与 MODEL_NAME 字段值。
3、保存文件后，在终端中执行 source .env（Linux/macOS）或 Set-Content .env -Raw | Invoke-Expression（PowerShell）加载变量。
四、启动开发服务器与 CLI 工具
本地开发环境支持双模式交互：WebUI 实时调试界面与 CLI 命令行快速验证，二者共享同一运行时上下文，便于同步观测状态变化。
1、在项目根目录下，启动后端服务：
python -m hermes.server
2、另起终端窗口，启动前端开发服务器：
cd frontend
npm run dev
3、浏览器访问 http://localhost:5173 查看 WebUI 界面。
4、在任意目录下，全局启用 CLI 工具（需先完成 pip install -e .）：
pip install -e .
hermes --help
五、启用调试日志与技能热重载
为提升本地开发效率，Hermes Agent 提供细粒度日志输出与技能模块热重载机制，无需重启服务即可验证新编写的技能逻辑是否生效。
1、启动服务时添加调试参数：
python -m hermes.server --log-level DEBUG
2、将自定义技能脚本置于 skills/ 子目录下，文件名以 skill_ 开头、.py 结尾。
3、修改 skill_*.py 文件后，WebUI 中点击 “Reload Skills” 按钮，或向 /api/skills/reload 发送 POST 请求触发热重载。
4、观察终端输出中包含 [SKILL] Loaded skill_xxx 日志即表示加载成功。
