A modern way to let AI-agents Communicate
Project description
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file holorelay-0.1.0.tar.gz.
File metadata
- Download URL: holorelay-0.1.0.tar.gz
- Upload date:
- Size: 2.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
20d9b8c6eb596c81dcf111ca527dc688228946a6f460567bd0a18df2464ce7e0
|
|
| MD5 |
0b6be94f830a1206924376c65eab3f8f
|
|
| BLAKE2b-256 |
99c3b9d68e17261b24a98d26f814957083ae35dce46b25dcd3b9b5285f402b55
|
File details
Details for the file holorelay-0.1.0-py3-none-any.whl.
File metadata
- Download URL: holorelay-0.1.0-py3-none-any.whl
- Upload date:
- Size: 3.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.0.1 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04bb6efad8dcfb945be6dee367b0866a6e800cfdc0fa4830b086deb593e09354
|
|
| MD5 |
29dc2632e858482dcb81f2313dd5ac61
|
|
| BLAKE2b-256 |
e068ec246e14bc6f8a59847dd6e546e48be56f22fd7f3e0d932435c88ba57309
|