Hermes Agent

Hermes Agent

在 Docker 的 Space 里运行 Hermes Agent 网关，通过两个机器人连接 Telegram，在 python-telegram-bot 传输之外再加上 Telethon 插件。

由 Mega-Evolutions 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这个 Space 在 Docker 容器里运行 Hermes Agent 网关。它加入 Telethon Telegram 平台插件，作为与 PTB 并行工作的第二条传输通道，所以两个使用不同令牌的 Telegram 机器人会同时运行。它需要持久存储，否则保存的会话在重启时会丢失。

适合谁：想把连接 Telegram 的智能体托管在 Hugging Face 上，并且愿意设置密钥和存储的人。

行业 | 谁在用 | 怎么用 | 例子
软件 | 聊天智能体的开发者 | 托管一个通过 Telegram 回答的智能体 | 部署 Space 并给机器人发消息
运营 | 小团队 | 让智能体在 Telegram 频道里随时可用 | 为智能体设置主频道
研究 | 智能体构建者 | 在一次部署里比较两种 Telegram 传输 | 并行运行 PTB 和 Telethon 机器人
自托管 | 爱好者 | 不用自己的服务器也能运行个人智能体 | 添加密钥并启动容器

想要不用设置的一键式助手的人可以跳过它，因为它需要两个机器人和多个密钥。

用在哪里：

• 带 Docker 和持久存储的 Hugging Face Space
• Telegram，通过你创建的两个机器人
• 装有 Docker 的 Windows、macOS 或 Linux，用于在自己的电脑上运行副本

用例 | 谁用 | 得到什么
和智能体聊天 | 所有者 | 智能体在 Telegram 里的回复
运行两条传输通道 | 开发者 | 并行工作的 PTB 和 Telethon 机器人
保留会话 | 运维人员 | 重启后仍然保留的状态

如何设置：

• Windows、macOS 或 Linux 上的 Docker，或者一个 Hugging Face Space
• 来自 BotFather 的 PTB 机器人令牌
• 第二个机器人令牌，用于 Telethon 机器人，来自另一个机器人
• 来自 Telegram 开发者网站的 Telegram API ID 和 API hash
• 你的 Telegram 用户 ID 和主频道 ID
• 挂载在 /data 的持久存储

1. 把这些密钥添加为 Space 的密钥，而不是变量。
2. 在 /data 启用持久存储。
3. 部署并等待 Docker 构建完成。
4. 两个机器人用各自的令牌并行运行。

pip install -U huggingface_hub
hf download Mega-Evolutions/Hermes-Agent --repo-type space --local-dir Hermes-Agent
cd Hermes-Agent
docker build -t hermes-agent .
docker run -it -p 7860:7860 hermes-agent

如何使用：Space 运行起来之后，在 Telegram 里给你创建的机器人发消息。来源只给出了 Space 用的密钥，所以本地运行需要同样的值，而来源没有显示怎么传入。

密钥 | 内容
TELEGRAM_BOT_TOKEN | PTB 机器人的令牌
TELETHON_BOT_TOKEN | 独立的 Telethon 机器人的令牌
TELETHON_API_ID | 来自 Telegram 开发者网站的 API ID
TELETHON_API_HASH | 来自 Telegram 开发者网站的 API hash
TELETHON_ALLOWED_USERS | 你的 Telegram 用户 ID
TELETHON_HOME_CHANNEL | 你的主频道 ID
TELETHON_PROXY | mtproto 被屏蔽时可选的 SOCKS5 代理信息

示例：你带着两个机器人令牌和你的用户 ID 部署 Space。然后你在 Telegram 里给 Telethon 机器人发一条消息，Hermes 智能体通过它回答。

新手与专家：如果你刚接触，先用 BotFather 创建两个机器人，并准备好它们的令牌。然后在部署之前把表里每个密钥都添加好，因为缺了它们机器人就不会启动。

如果你熟悉这个领域，这个网关同时使用 PTB 和 Telethon 两条 Telegram 传输通道，各用各的令牌。仓库里有用来保存状态的 hf_persist.py 和 00-hf-restore 脚本、一个 main.sh 入口脚本和一个 plugins 文件夹。如果 /data 没有持久存储，state.db 和所有会话在重启时都会消失。

你添加密钥和存储
Docker 镜像构建
网关启动两条传输通道
你在 Telegram 里给机器人发消息
智能体通过它回复

注意事项：

• Storage: 请在 /data 挂载持久存储，没有它，state.db 文件和你的会话会在每次重启时消失
• Secrets: 要作为密钥输入，而不是变量
• Proxy: mtproto 被屏蔽时，SOCKS5 代理是可选的
• License: mit
• Cost to run: 两个 Telegram 机器人令牌、一个 Telegram API ID 和 hash，以及持久存储
• Data it reaches: 你的 Telegram 机器人和频道，以及保存在 /data 下 state.db 里的会话

Hugging Face 上的数据（2026年11月13日）

• 点赞：3
• 构建方式：docker
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/Mega-Evolutions/Hermes-Agent
• 文件：https://huggingface.co/spaces/Mega-Evolutions/Hermes-Agent/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。