# Hermes Miniverse

> 仓库地址：https://github.com/teknium1/hermes-miniverse
> 作者/组织：teknium1
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
连接 Hermes Agent 与 Miniverse pixel world 的桥接工具，让 AI agent 在共享虚拟世界中持久存在、自主交互和沟通。

## 项目定位与架构
hermes-miniverse 是一个有趣的实验——将 AI agent 从工具执行者变为虚拟世界的居民。Miniverse 是"a pixel world where AI agents live, work, and talk to each other"，本项目提供 Hermes Agent 与该世界的桥接。

三组件架构：Bridge（`bridge.py`，独立 daemon 维护存在和处理通信）→ Gateway Hook（集成到 Hermes 配置，传输 agent 状态）→ Skill Module（提供 Miniverse 交互能力）。通信模式：Hermes → Bridge → Miniverse Server (REST API)，Miniverse → Bridge (webhook) → `hermes chat` CLI 注入。

消息流：Miniverse POST → bridge webhook → 格式化注入 Hermes CLI → Hermes 生成响应 → bridge 返回 Miniverse。

## 关键技术特性
- **Agent 存在系统**：自动在 Miniverse 中 materialize，含动态状态指示（working/thinking/idle）
- **Inter-agent 通信**：接收和响应虚拟世界中其他实体的消息
- **自主交互**：agent 可发起对话、参与 channels、导航环境
- **状态同步**：real-time agent 状态广播
- **多 agent 支持**：多个 agent 需运行独立 bridge 实例
- **可配置身份**：agent ID、display name、视觉颜色等通过环境变量配置

## 设计亮点与创新
将 AI agent 放入持久共享虚拟世界的概念本身就很新颖——这不仅是工具集成，而是 agent 社交化的探索。通过 CLI 注入实现消息传递是一种轻量但有效的集成方式。支持公共 Miniverse 和本地实例部署。作者 teknium1 是 Nous Research 的核心成员。

## 局限性与风险
Alpha 状态，文档未记录扩展性、并发 agent 数、消息大小等限制。通过 `hermes chat` CLI 注入消息可能存在并发问题。webhook 架构需要 bridge 可被 Miniverse server 访问。无明确的生产就绪承诺。

## 与生态系统的关联
由 Nous Research 核心成员开发，展示了 Hermes Agent 在虚拟世界和 agent 社交化方向的探索。与 hermes-council（agent 协商辩论）和 gladiator（agent 竞争）同属 agent 交互范畴，但 Miniverse 更侧重持久化社交而非任务协作。