必须完整克隆并安装all依赖才能运行Hermes Agent实战项目：执行git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git，cd hermes-agent，再uv pip install -e ".[all]"，最后运行python examples/chat-with-memory.py等示例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已克隆 Hermes Agent 仓库并希望快速启动一个可验证的实战项目，但执行时出现命令未识别、技能加载失败或网关无响应等问题，则可能是由于项目结构未正确初始化或源码依赖路径未对齐。以下是复现并运行 Hermes Agent 实战项目的具体步骤：
一、确认项目根目录与源码完整性
实战项目依赖于 Hermes Agent 仓库中特定子目录（如 examples/、skills/、tests/agent/）下的源码文件，若仅复制部分代码或使用非官方分支，会导致模块导入错误或 hermes CLI 无法解析子命令。必须确保使用官方推荐的完整克隆方式获取源码。
1、打开终端，执行克隆命令：git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git。
2、进入项目根目录：cd hermes-agent。
3、验证源码完整性：检查是否存在 examples/chat-with-memory.py、skills/mlops/pennylane/ 和 tests/agent/test_subagent_progress.py 等路径。
二、安装含实战组件的完整依赖
Hermes Agent 的实战功能（如飞书网关、量子技能、RAG 工具链）被划分为可选 extras 模块，若仅执行 pip install -e .，将缺失关键实战源码支持。必须显式启用 all 或对应功能组。
1、使用 uv 安装全功能依赖（推荐）：uv pip install -e ".[all]"。
2、若使用 pip，请确保包含飞书与测试模块：pip install -e ".[feishu,testing]"。
3、验证是否识别实战命令：hermes skills list 应输出包含 mlops/pennylane、mlops/qiskit 等条目。
三、运行内置实战示例脚本
官方提供的 examples/ 目录下封装了可直接执行的端到端实战源码，无需额外配置即可触发记忆、技能调用与模型交互闭环，是验证项目源码可用性的最简路径。
1、执行带持久化记忆的对话示例：python examples/chat-with-memory.py。
2、运行飞书网关本地调试实例：hermes-feishu --dev --log-level debug。
3、触发量子技能测试流程：pytest tests/agent/test_subagent_progress.py -v。
四、定位实战源码中的关键模块路径
Hermes Agent 实战能力由分散在不同目录的源码协同驱动，理解各路径职责有助于快速修改或扩展功能。所有路径均以项目根目录 ~/hermes-agent 为基准。
1、核心代理逻辑实现在：src/hermes/agent/ 目录下的 core.py 与 loop.py。
2、飞书网关源码位于：src/hermes/gateways/feishu/，其中 server.py 为 HTTP 入口。
3、用户记忆与技能文档默认存储于：~/hermes-agent/memory.md 与 ~/hermes-agent/skills/ 子目录。
五、从 GitHub 获取最新实战源码快照
若本地仓库存在提交冲突或 submodule 同步异常，可能导致 examples/ 或 skills/ 内容缺失。应强制拉取最新源码并重置子模块状态，确保与官方主干一致。
1、同步远程更新：git pull origin main。
2、递归更新子模块：git submodule update --init --recursive。
3、校验当前提交哈希是否匹配官方 v0.7.3 标签：git describe --tags --exact-match 应返回 v0.7.3。
