拒绝 C 盘漂红：2026 终极版 Hermes-Agent 源码部署与 EPGF 闭环实战

love530love · 2026-06-11 16:35:29 发布

针对 Hermes-Agent 这一强大的多平台自主智能体，结合我们之前推导出的 EPGF 架构（环境隔离、包精准管理、全局防污染、文件落盘可控），我们撰写了这篇深度部署指南。

2026年终极防坑指南：基于 EPGF 架构彻底“本地化” UV 环境与工具

这篇文章作为系列博文的第二篇，重点在于从“源码克隆”到“全功能激活”的实操过程。

NousResearch / hermes-agent

在上一篇文章中，我们详细讨论了如何利用 uv 打造一个纯净的本地 Python 环境。今天，我们将这套 EPGF 架构 落地到实际项目中——部署目前 GitHub 上最火的自主智能体：NousResearch/Hermes-Agent。
Hermes-Agent 不仅仅是一个聊天机器人，它是一个支持 MCP（模型上下文协议）、具备 自我进化能力（Closed-loop Learning） 且能无缝接入 Telegram、Slack、Discord 的全能型数字分身。

Hermes-Agent 默认的安装脚本会向 %LOCALAPPDATA% 写入数 GB 的环境与模型数据。为了保护我们的 C 盘，本次部署严格遵循以下规范：
非系统盘落盘：所有代码与环境强制安装在 K 盘。
工具本地化：uv 与 python 解释器完全由项目内部的 .venv 供给。
依赖全量化：通过 [all] 标识符一次性激活所有扩展功能（MCP、多端连接器等）。

【EPGF 白皮书】路径治理驱动的多版本 Python 架构—— Windows 环境治理与 AI 教学开发体系

uv venv 为何没有 pip？—— 揭秘现代 Python 工具链的“动态治理”挑战与 EPGF 的应对之道

EPGF 新手教程 07所有“虚拟环境工具”到底是什么？——一次看懂 venv / virtualenv / conda / uv / poetry / hatch（不再混乱）

EPGF 新手教程 11在 PyCharm（中文版 GUI）中创建 uv 环境，并把 uv 做到“项目自包含”（工具本地化为必做环节）

【笔记】加速 uv 安装：系统环境变量配置国内镜像源

一次搭好、终身不乱Windows Python 环境治理（EPGF）系列总览 / 阅读路线图 [目录]

【EPGF 白皮书】路径治理驱动的多版本 Python 架构—— Windows 环境治理与 AI 教学开发体系

Python 多版本环境治理理念驱动的系统架构设计——三维治理、四级隔离、五项自治原则（路径治理升级修订 V 2.0 版）
————————————————

首先，在我们选定的工作盘（K 盘）克隆代码。不要使用官方的一键脚本，我们需要完全的控制权。

DOS

K:
cd \PythonProjects5
git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent

2026年终极防坑指南：基于 EPGF 架构彻底“本地化” UV 环境与工具

利用我们之前验证过的“最稳命令”，强制绑定 Python 3.11，并解决跨盘符链接警告。

DOS

# 强制播种基础包，锁定3.11版本，开启拷贝模式
uv venv --seed .venv --python 3.11 --link-mode=copy

# 激活环境
.venv\Scripts\activate

为了实现 100% 的环境自治，我们把包管理器也装进项目里：

DOS

uv pip install uv --link-mode=copy

此时执行 where uv，输出应指向 K 盘路径。

Hermes-Agent 拥有极其丰富的插件系统，我们使用 -e（编辑模式）和 [all] 选项，确保所有连接器和 MCP 工具集一次性安装到位：

DOS

uv pip install --link-mode=copy -e ".[all]"

这一步会安装约 90-100 个依赖包。由于 uv 的高性能，在 2026 年的宽带环境下，通常在 20 秒内即可完成。

安装完成后，你的 hermes 命令已就绪。

DOS

hermes setup

在这个阶段，你需要配置：

如果你希望在手机上通过 Telegram 控制你的 Agent，只需在项目根目录的 .env 文件中配置 TELEGRAM_BOT_TOKEN，然后运行：

DOS

hermes --platform telegram

迁移无忧：由于使用了 --link-mode=copy，整个 hermes-agent 文件夹可以整体移动到其他盘符或移动硬盘，只需重新激活环境即可运行，不产生任何系统依赖。
MCP 协议兼容性：通过 --seed 注入的 setuptools 确保了后续动态加载第三方 MCP 服务（如 GitHub、Google 搜索插件）时的编译兼容性。
极速启动：本地化的 uv 避免了 Windows 环境变量扫描延迟，秒速唤醒你的数字分身。