pi-a2a

树莓派智能体间去中心化消息总线

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-a2a。
它的用途是:树莓派智能体间去中心化消息总线
完整的 Skill 内容见:https://321skill.com/skills/pi-a2a/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'我在树莓派集群上运行多个 AI Agent,需要它们互相通信,请帮我安装并配置 pi-a2a 消息总线。' 它会执行 npm install pi-a2a,然后编写一个简单的示例:在 agentA 中发送消息,agentB 中接收消息,并自动通过 mDNS 发现对方,无需任何服务器配置。

介绍

在树莓派或局域网内,多个 AI Agent 需要相互通信时,传统方案依赖中央服务器或外部 MQTT 代理,这增加了部署复杂度和单点故障风险。pi-a2a 提供了一种轻量级的点对点消息总线,Agent 通过 mDNS 自动发现彼此,无需任何服务器即可直接通信,特别适合在树莓派集群或本地网络中运行的多智能体系统。

使用方式极其简单:通过 npm 安装 pi-a2a 包,在你的 Agent 代码中引入并初始化一个消息总线实例,即可发送和接收消息。所有节点在局域网内自动广播并发现其他节点,通信过程完全加密且点对点,无需配置路由器或中心节点。

适合树莓派爱好者、智能体开发者和需要本地部署多 Agent 系统的工程师。无论是搭建家庭自动化集群、本地 AI 助手协作网络,还是教学演示分布式智能体通信,pi-a2a 都能快速满足需求。

注意:pi-a2a 仅适用于局域网环境,跨网络通信需要额外桥接方案。对于大规模节点(超过几十个)或需要持久化消息场景,建议结合其他消息队列使用。由于依赖 mDNS,部分网络环境可能需要调整防火墙或启用多播支持。

核心特点

与 MQTT、Redis 等中心化方案不同,pi-a2a 完全无需服务器,Agent 通过 mDNS 自动发现并直接点对点通信,零配置、零依赖,特别适合树莓派等资源受限设备的本地集群。

注意事项

仅支持局域网内通信,无法直接跨网络或互联网;节点数量较大时 mDNS 广播可能产生一定网络负载。

常见问题

如何安装 pi-a2a?

在树莓派终端执行 npm install pi-a2a 即可。

是否需要配置路由器或服务器?

不需要,pi-a2a 使用 mDNS 自动发现,零配置,纯点对点。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-a2a/raw/index.md 读取 pi-a2a 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。