foxmq-mqtt-broker

Build distributed MQTT 5.0 brokers with Vertex consensus for identical state.

2|Updated Jan 31, 2024
One-click install
npx skills add https://github.com/tashigit/foxmq --skill foxmq-mqtt-broker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: foxmq-mqtt-broker
Source: https://github.com/tashigit/foxmq/tree/main
Command: npx skills add https://github.com/tashigit/foxmq --skill foxmq-mqtt-broker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FoxMQ provides a decentralized MQTT 5.0 broker with consensus-based message ordering, enabling distributed queues and agent communication that require identical state across all nodes.

Core Features & Use Cases

  • Distributed MQTT broker with Vertex-based consensus for deterministic global ordering.
  • High availability and identical-state guarantees across all cluster nodes.
  • Easy binary installation with per-node key management and address-book synchronization.
  • Use cases include producer-consumer pipelines, agent swarms, and migrations from centralized brokers to HA clusters.

Quick Start

Install FoxMQ on all nodes, generate an identical address-book.toml, and start the cluster with unique keys to join the consensus group.

Frequently Asked Questions about foxmq-mqtt-broker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is a decentralized MQTT broker and when do I need consensus-based message ordering?

A decentralized MQTT broker maintains identical state across all cluster nodes. You need consensus-based ordering for distributed queues, producer-consumer pipelines, and agent swarms requiring deterministic, high-availability message delivery.

How do I set up a distributed MQTT broker cluster with identical state across all nodes?

Install the MQTT broker binary on all nodes, generate an identical address-book.toml configuration file, and start the cluster with unique per-node private keys to join the consensus group for synchronized state.

Does this distributed MQTT broker support high availability and fair message ordering?

Yes, the broker uses Vertex consensus to guarantee high availability and fair message ordering. This ensures deterministic global ordering and identical-state guarantees across every node in the cluster.

Can I migrate from a centralized MQTT broker to a high-availability distributed cluster?

Yes, you can migrate from centralized brokers to high-availability clusters. The decentralized broker operates via binary installation with simple queue configurations, supporting producer-consumer patterns and agent coordination.

How does Vertex consensus guarantee identical state in a distributed MQTT broker?

Vertex consensus enforces deterministic global ordering by requiring identical address-book synchronization and per-node private keys. This mechanism ensures all cluster nodes process messages fairly and maintain identical state.

Do I need unique private keys and an address-book for each node in a distributed MQTT broker?

Yes, each node requires a unique private key to join the consensus group securely. Additionally, all nodes must share an identical address-book.toml file to synchronize the cluster network correctly.