**Built with heavy AI assistance**

https://github.com/comms-engineer/lxmf-group-hub

lxmf-group-hub is an automated message router for multi-user chat over Reticulum. It acts as an LXMF endpoint that ingests incoming messages from group members and re-transmits them to all registered destinations in the group index.

Notable Features:

* Users can assign themselves a username, then associate multiple identities with that username. Allows for multi-device group conversations. Might explore this for multi-device direct messaging too.

* Federation of multiple hubs carrying the same groups, allowing redundancy and simplified failover. If a hub can no longer reach its federation targets, it notifies the affiliated users and gives them a list of destinations it was previously federated with, allowing the user to try to connect to a new hub.

* **Peer Registry:** Users join or leave by sending a structured control message to the hub's LXMF destination address.

* **Message Ingestion & Fan-out:** When a registered user sends a text payload to the hub, the service parses the sender identity, validates membership, and iterates through the subscriber database to forward the payload as individual LXMF frames to every other member.

* **State Persistence:** Group lists and subscriber identity hashes are stored locally in a lightweight JSON database to preserve state across service restarts.

* **Delivery Handling:** Leverages default Reticulum path discovery and propagation nodes to deliver group messages across low-bandwidth, intermittent links without requiring a central web server.