HoloRelay 0.1.0

HoloRelay is a zero-dependency, production-ready message router for agent-to-agent communication in Python.
It lets you send and receive messages between named agents—perfect for coordinating tasks in multi-agent systems, toolchains, or even distributed apps.

Install

pip install HoloRelay

Usage

from HoloRelay import HoloRelay

ata = HoloRelay()

# Send a message from one agent to another
ata.send("Alpha", "Bravo", "Ping from Alpha!")

# Agent Bravo receives their messages
messages = ata.receive("Bravo")
print(messages)
# Output: [{'from': 'Alpha', 'to': 'Bravo', 'content': 'Ping from Alpha!'}]

# Support for filtering by sender
ata.send("Alpha", "Charlie", "Hello, Charlie!")
ata.send("Beta", "Charlie", "Hi, Charlie!")
msgs = ata.receive("Charlie", allowedFrom=["Beta"])
print(msgs)
# Output: [{'from': 'Beta', 'to': 'Charlie', 'content': 'Hi, Charlie!'}]

Features

• Direct agent-to-agent messaging – Send and receive by agent name.
• Broadcasting – Send to all by using toAgent=None.
• Filtered receive – Optionally receive only from allowed senders.
• In-memory queue – Each receive call pulls all available messages.
• Zero dependencies – No third-party packages required.
• Works with any agent framework – Simple plug-and-play for any system.

Code Examples

You can find code examples on my GitHub repository.

License

Apache License 2.0

Acknowledgements

Project by:

• Tristan McBride Sr.
• Sybil