Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

holorelay-0.1.0.tar.gz (2.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

holorelay-0.1.0-py3-none-any.whl (3.0 kB view details)

Uploaded Python 3

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

Hashes for holorelay-0.1.0.tar.gz
Algorithm Hash digest
SHA256 20d9b8c6eb596c81dcf111ca527dc688228946a6f460567bd0a18df2464ce7e0
MD5 0b6be94f830a1206924376c65eab3f8f
BLAKE2b-256 99c3b9d68e17261b24a98d26f814957083ae35dce46b25dcd3b9b5285f402b55

See more details on using hashes here.

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

Hashes for holorelay-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 04bb6efad8dcfb945be6dee367b0866a6e800cfdc0fa4830b086deb593e09354
MD5 29dc2632e858482dcb81f2313dd5ac61
BLAKE2b-256 e068ec246e14bc6f8a59847dd6e546e48be56f22fd7f3e0d932435c88ba57309

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page