Hermes Agent 定制指南4步从默认配置到场景化部署【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent 是一个自我改进的个人 AI 智能代理同一个 agent 核心跑在终端、IM 网关和桌面端边用边积累技能与记忆。读完你能跑通 setup 向导、完成第一次对话并拿到切换模型、管理工具、定制主题三条可落地的自定义路径。这张图展示 Hermes Agent 桌面应用里的会话面板与源码文件夹正是 agent 理解你是谁、你在改什么的入口。 最小可用路径# 最短跑通链路克隆 → 装依赖 → 向导 → 开聊 git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent uv sync --all-extras # Hermes 用 uv 管 Python 环境一行装齐依赖 uv run hermes setup # 交互向导选模型、填 key、勾选工具再执行uv run hermes进入终端对话问它任意问题看到流式回复逐步打出 链路通了。最常见的第一个坑向导只负责收集 key不校验真伪——~/.hermes/.env里的 key 填错第一条消息就会报 provider 错误此时先跑hermes doctor自检别急着怀疑网络。⚙️ 核心机制速览Hermes 的设计原则是核心是细腰能力在边缘核心只负责把对话跑完新能力尽量以技能和插件挂在边缘而不是改核心。run_agent.pyAIAgent大脑。管理调模型 → 调工具 → 回填结果的循环max_iterations默认 500 轮防工具调用失控。gateway/消息网关前台。同一个 agent 接到 Telegram、Discord、Slack 等二十多个平台你在手机上发消息活在云 VM 里的 agent 继续干活。agent/记忆与技能内务图书管理员。管跨会话记忆、技能自动创建、提示缓存、上下文压缩自我改进就发生在这里。# run_agent.py 对外核心接口一次调用就拿到最终回复 agent AIAgent(provideropenrouter, model) # model 留空则取 config final agent.chat(帮我整理这个目录)工具侧还有个小机关tools/registry.py负责自动发现——任何tools/*.py里调了registry.register()就会被导入注册但能否暴露给模型取决于它是否被收进某个 toolset。这个注册与暴露分离的设计是你后面裁剪工具集时能动手的地方。 按需定制换模型和供应商不碰代码场景OpenRouter 额度用完了想换 Gemini 或本地 Ollama。改哪里~/.hermes/.env只放 key 这类秘密和~/.hermes/config.yaml放一切行为参数。改什么跑hermes model交互式选 provider 和模型模型名写进config.yaml的model.default千万别塞进.env——项目明确约定 env 只放密钥。验证方式hermes config get model.default打印出新值再在对话里让它自我介绍确认回答风格真的换了。只留你需要的工具集场景agent 跑在无头服务器上浏览器、图像生成这些用不上还白白占每次 API 调用的 schema 成本。改哪里hermes tools交互开关底层对应toolsets.py的 toolset 定义。改什么toolset 是最小启停单元按组取消勾选即可不需要逐个工具删。验证方式重启后让它打开某个网页它明确回答没有这个能力说明裁剪生效。定制 CLI 主题皮肤场景终端 UI 太素想换成自己的配色和启动画面文案。改哪里~/.hermes/skins/下放一个 YAMLconfig.yaml的display.skin指向它。改什么皮肤是纯数据——banner 颜色、spinner 表情、工具前缀、品牌文案全在 YAML 里零代码。验证方式# ~/.hermes/config.yaml 片段模型与主题都走配置 model: default: anthropic/claude-opus-4.6 # 模型名归 config 管 display: skin: my-skin # 即 ~/.hermes/skins/my-skin.yaml重启hermes后 banner 配色和加载动画应该变了会话中打/skin可随时热切换。 调优与排障性能侧两个关键参数max_iterations默认 500。复杂多步任务保持默认纯问答场景压到 50–100能掐掉失控的工具循环token 账单立省。提示缓存 TTLagent/prompt_caching.py默认 5 分钟长对话可开 1 小时档。缓存命中率直接决定长会话的 token 成本回合间隔常超 5 分钟的话开 1h 档更划算。稳定性侧日志在~/.hermes/logs/agent.log收 INFO 及以上errors.log只收 WARNING 及以上跑着网关时另有gateway.log。3 步定位法# 排障三步环境自检 → 实时跟日志 → 按会话缩小范围 hermes doctor hermes logs --follow --level DEBUG hermes logs --session 会话ID复现问题时先翻errors.log找第一条 WARNING再到agent.log里按 session 追上下文基本不用满代码库搜。 延伸索引中文入门说明README.zh-CN.md环境变量模板各家 provider 的 key 清单.env.example核心内务源码记忆 / 提示缓存 / 压缩agent/桌面应用源码与 e2e 用例apps/desktop/架构约定与贡献规范AGENTS.md现在就去跑一次hermes tools取消勾选一个你确定不用的工具集再对话一轮试试效果。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Hermes Agent 定制指南：4步从默认配置到场景化部署
Hermes Agent 定制指南4步从默认配置到场景化部署【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent 是一个自我改进的个人 AI 智能代理同一个 agent 核心跑在终端、IM 网关和桌面端边用边积累技能与记忆。读完你能跑通 setup 向导、完成第一次对话并拿到切换模型、管理工具、定制主题三条可落地的自定义路径。这张图展示 Hermes Agent 桌面应用里的会话面板与源码文件夹正是 agent 理解你是谁、你在改什么的入口。 最小可用路径# 最短跑通链路克隆 → 装依赖 → 向导 → 开聊 git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent uv sync --all-extras # Hermes 用 uv 管 Python 环境一行装齐依赖 uv run hermes setup # 交互向导选模型、填 key、勾选工具再执行uv run hermes进入终端对话问它任意问题看到流式回复逐步打出 链路通了。最常见的第一个坑向导只负责收集 key不校验真伪——~/.hermes/.env里的 key 填错第一条消息就会报 provider 错误此时先跑hermes doctor自检别急着怀疑网络。⚙️ 核心机制速览Hermes 的设计原则是核心是细腰能力在边缘核心只负责把对话跑完新能力尽量以技能和插件挂在边缘而不是改核心。run_agent.pyAIAgent大脑。管理调模型 → 调工具 → 回填结果的循环max_iterations默认 500 轮防工具调用失控。gateway/消息网关前台。同一个 agent 接到 Telegram、Discord、Slack 等二十多个平台你在手机上发消息活在云 VM 里的 agent 继续干活。agent/记忆与技能内务图书管理员。管跨会话记忆、技能自动创建、提示缓存、上下文压缩自我改进就发生在这里。# run_agent.py 对外核心接口一次调用就拿到最终回复 agent AIAgent(provideropenrouter, model) # model 留空则取 config final agent.chat(帮我整理这个目录)工具侧还有个小机关tools/registry.py负责自动发现——任何tools/*.py里调了registry.register()就会被导入注册但能否暴露给模型取决于它是否被收进某个 toolset。这个注册与暴露分离的设计是你后面裁剪工具集时能动手的地方。 按需定制换模型和供应商不碰代码场景OpenRouter 额度用完了想换 Gemini 或本地 Ollama。改哪里~/.hermes/.env只放 key 这类秘密和~/.hermes/config.yaml放一切行为参数。改什么跑hermes model交互式选 provider 和模型模型名写进config.yaml的model.default千万别塞进.env——项目明确约定 env 只放密钥。验证方式hermes config get model.default打印出新值再在对话里让它自我介绍确认回答风格真的换了。只留你需要的工具集场景agent 跑在无头服务器上浏览器、图像生成这些用不上还白白占每次 API 调用的 schema 成本。改哪里hermes tools交互开关底层对应toolsets.py的 toolset 定义。改什么toolset 是最小启停单元按组取消勾选即可不需要逐个工具删。验证方式重启后让它打开某个网页它明确回答没有这个能力说明裁剪生效。定制 CLI 主题皮肤场景终端 UI 太素想换成自己的配色和启动画面文案。改哪里~/.hermes/skins/下放一个 YAMLconfig.yaml的display.skin指向它。改什么皮肤是纯数据——banner 颜色、spinner 表情、工具前缀、品牌文案全在 YAML 里零代码。验证方式# ~/.hermes/config.yaml 片段模型与主题都走配置 model: default: anthropic/claude-opus-4.6 # 模型名归 config 管 display: skin: my-skin # 即 ~/.hermes/skins/my-skin.yaml重启hermes后 banner 配色和加载动画应该变了会话中打/skin可随时热切换。 调优与排障性能侧两个关键参数max_iterations默认 500。复杂多步任务保持默认纯问答场景压到 50–100能掐掉失控的工具循环token 账单立省。提示缓存 TTLagent/prompt_caching.py默认 5 分钟长对话可开 1 小时档。缓存命中率直接决定长会话的 token 成本回合间隔常超 5 分钟的话开 1h 档更划算。稳定性侧日志在~/.hermes/logs/agent.log收 INFO 及以上errors.log只收 WARNING 及以上跑着网关时另有gateway.log。3 步定位法# 排障三步环境自检 → 实时跟日志 → 按会话缩小范围 hermes doctor hermes logs --follow --level DEBUG hermes logs --session 会话ID复现问题时先翻errors.log找第一条 WARNING再到agent.log里按 session 追上下文基本不用满代码库搜。 延伸索引中文入门说明README.zh-CN.md环境变量模板各家 provider 的 key 清单.env.example核心内务源码记忆 / 提示缓存 / 压缩agent/桌面应用源码与 e2e 用例apps/desktop/架构约定与贡献规范AGENTS.md现在就去跑一次hermes tools取消勾选一个你确定不用的工具集再对话一轮试试效果。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考