| Name | HoloRelay JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | A modern way to let AI-agents Communicate |
| upload_time | 2025-08-06 01:15:25 |
| maintainer | None |
| docs_url | None |
| author | Tristan McBride Sr. |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
---
**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
```sh
pip install HoloRelay
````
---
## Usage
```python
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](https://github.com/TristanMcBrideSr/TechBook).
---
## License
Apache License 2.0
---
## Acknowledgements
Project by:
- Tristan McBride Sr.
- Sybil
Raw data
{
"_id": null,
"home_page": null,
"name": "HoloRelay",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Tristan McBride Sr.",
"author_email": "\"Tristan McBride Sr.\" <142635792+TristanMcBrideSr@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/99/c3/b9d68e17261b24a98d26f814957083ae35dce46b25dcd3b9b5285f402b55/holorelay-0.1.0.tar.gz",
"platform": null,
"description": "\ufeff\r\n---\r\n\r\n**HoloRelay** is a zero-dependency, production-ready message router for agent-to-agent communication in Python. \r\nIt lets you send and receive messages between named agents\u2014perfect for coordinating tasks in multi-agent systems, toolchains, or even distributed apps.\r\n\r\n---\r\n\r\n## Install\r\n\r\n```sh\r\npip install HoloRelay\r\n````\r\n\r\n---\r\n\r\n## Usage\r\n\r\n```python\r\nfrom HoloRelay import HoloRelay\r\n\r\nata = HoloRelay()\r\n\r\n# Send a message from one agent to another\r\nata.send(\"Alpha\", \"Bravo\", \"Ping from Alpha!\")\r\n\r\n# Agent Bravo receives their messages\r\nmessages = ata.receive(\"Bravo\")\r\nprint(messages)\r\n# Output: [{'from': 'Alpha', 'to': 'Bravo', 'content': 'Ping from Alpha!'}]\r\n\r\n# Support for filtering by sender\r\nata.send(\"Alpha\", \"Charlie\", \"Hello, Charlie!\")\r\nata.send(\"Beta\", \"Charlie\", \"Hi, Charlie!\")\r\nmsgs = ata.receive(\"Charlie\", allowedFrom=[\"Beta\"])\r\nprint(msgs)\r\n# Output: [{'from': 'Beta', 'to': 'Charlie', 'content': 'Hi, Charlie!'}]\r\n```\r\n\r\n---\r\n\r\n## Features\r\n\r\n* **Direct agent-to-agent messaging** \u2013 Send and receive by agent name.\r\n* **Broadcasting** \u2013 Send to all by using `toAgent=None`.\r\n* **Filtered receive** \u2013 Optionally receive only from allowed senders.\r\n* **In-memory queue** \u2013 Each receive call pulls all available messages.\r\n* **Zero dependencies** \u2013 No third-party packages required.\r\n* **Works with any agent framework** \u2013 Simple plug-and-play for any system.\r\n\r\n---\r\n\r\n## Code Examples\r\n\r\nYou can find code examples on my [GitHub repository](https://github.com/TristanMcBrideSr/TechBook).\r\n\r\n---\r\n\r\n## License\r\n\r\nApache License 2.0\r\n\r\n---\r\n\r\n## Acknowledgements\r\n\r\nProject by:\r\n- Tristan McBride Sr.\r\n- Sybil\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A modern way to let AI-agents Communicate",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/TristanMcBrideSr"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e068ec246e14bc6f8a59847dd6e546e48be56f22fd7f3e0d932435c88ba57309",
"md5": "29dc2632e858482dcb81f2313dd5ac61",
"sha256": "04bb6efad8dcfb945be6dee367b0866a6e800cfdc0fa4830b086deb593e09354"
},
"downloads": -1,
"filename": "holorelay-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "29dc2632e858482dcb81f2313dd5ac61",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 2993,
"upload_time": "2025-08-06T01:15:24",
"upload_time_iso_8601": "2025-08-06T01:15:24.150644Z",
"url": "https://files.pythonhosted.org/packages/e0/68/ec246e14bc6f8a59847dd6e546e48be56f22fd7f3e0d932435c88ba57309/holorelay-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "99c3b9d68e17261b24a98d26f814957083ae35dce46b25dcd3b9b5285f402b55",
"md5": "0b6be94f830a1206924376c65eab3f8f",
"sha256": "20d9b8c6eb596c81dcf111ca527dc688228946a6f460567bd0a18df2464ce7e0"
},
"downloads": -1,
"filename": "holorelay-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "0b6be94f830a1206924376c65eab3f8f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 2741,
"upload_time": "2025-08-06T01:15:25",
"upload_time_iso_8601": "2025-08-06T01:15:25.428825Z",
"url": "https://files.pythonhosted.org/packages/99/c3/b9d68e17261b24a98d26f814957083ae35dce46b25dcd3b9b5285f402b55/holorelay-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-06 01:15:25",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "holorelay"
}
