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.