{"id":14779619,"url":"https://github.com/robustmq/robustmq","last_synced_at":"2026-04-01T21:35:32.561Z","repository":{"id":186673483,"uuid":"674088481","full_name":"robustmq/robustmq","owner":"robustmq","description":"Next-generation unified communication infrastructure for AI, IoT, and big data","archived":false,"fork":false,"pushed_at":"2026-02-17T01:34:32.000Z","size":61889,"stargazers_count":1515,"open_issues_count":104,"forks_count":213,"subscribers_count":30,"default_branch":"main","last_synced_at":"2026-02-17T08:03:54.722Z","etag":null,"topics":["ai","amqp","data","infra","kafka","message","message-queue","middleware","mq","mqtt","mqtt-broker","queue","rust","serverless","storage","streaming"],"latest_commit_sha":null,"homepage":"http://robustmq.com/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robustmq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-03T05:47:54.000Z","updated_at":"2026-02-17T01:22:24.000Z","dependencies_parsed_at":"2023-10-17T00:12:49.274Z","dependency_job_id":"895d3649-1e95-4af4-b041-55c7bf9c4dbe","html_url":"https://github.com/robustmq/robustmq","commit_stats":null,"previous_names":["robustmq/robustmq"],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/robustmq/robustmq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robustmq%2Frobustmq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robustmq%2Frobustmq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robustmq%2Frobustmq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robustmq%2Frobustmq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robustmq","download_url":"https://codeload.github.com/robustmq/robustmq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robustmq%2Frobustmq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29671513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T00:11:43.526Z","status":"online","status_checked_at":"2026-02-21T02:00:07.432Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","amqp","data","infra","kafka","message","message-queue","middleware","mq","mqtt","mqtt-broker","queue","rust","serverless","storage","streaming"],"created_at":"2024-09-17T01:00:54.598Z","updated_at":"2026-04-01T21:35:32.541Z","avatar_url":"https://github.com/robustmq.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg alt=\"RobustMQ Logo\" src=\"docs/images/robustmq-logo.png\" width=\"300\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://deepwiki.com/robustmq/robustmq\"\u003e\u003cimg src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://zread.ai/robustmq/robustmq\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/Ask_Zread-_.svg?style=flat\u0026color=00b0aa\u0026labelColor=000000\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K\u0026logoColor=ffffff\" alt=\"zread\"/\u003e\u003c/a\u003e\n  \u003cimg alt=\"Latest Release\" src=\"https://img.shields.io/github/v/release/robustmq/robustmq?style=flat\"\u003e\n  \u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/robustmq/robustmq?style=flat\"\u003e\n  \u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/robustmq/robustmq?style=flat\"\u003e\n  \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/robustmq/robustmq?style=flat\"\u003e\n  \u003ca href=\"https://codecov.io/gh/robustmq/robustmq\"\u003e\n    \u003cimg src=\"https://codecov.io/gh/robustmq/robustmq/graph/badge.svg?token=MRFFAX9QZO\" alt=\"Coverage\"/\u003e\n  \u003c/a\u003e\n  \u003cimg alt=\"Build Status\" src=\"https://img.shields.io/github/actions/workflow/status/robustmq/robustmq/ci.yml?branch=main\u0026style=flat\"\u003e\n  \u003cimg alt=\"Rust Version\" src=\"https://img.shields.io/badge/rust-1.70+-orange.svg\"\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Communication infrastructure for the AI era — one binary, one broker, one storage layer, any protocol\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-what-is-robustmq\"\u003eWhat is RobustMQ\u003c/a\u003e •\n  \u003ca href=\"#-mq9--agent-mailbox-for-ai\"\u003emq9\u003c/a\u003e •\n  \u003ca href=\"#-features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#%EF%B8%8F-roadmap\"\u003eRoadmap\u003c/a\u003e •\n  \u003ca href=\"#-quick-start\"\u003eQuick Start\u003c/a\u003e •\n  \u003ca href=\"#-documentation\"\u003eDocumentation\u003c/a\u003e •\n  \u003ca href=\"#-contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#-community\"\u003eCommunity\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003e **⚠️ Development Status**\n\u003e RobustMQ is in early development and **not yet production-ready**. MQTT core is stable and continuing to mature. Kafka, NATS, and AMQP are under active development. Production readiness is targeted for 0.4.0.\n\n---\n\n## 🌟 What is RobustMQ\n\nRobustMQ is a unified messaging engine built with Rust. One binary, one broker, no external dependencies — deployable from edge devices to cloud clusters. It natively supports MQTT, Kafka, NATS, AMQP, and **mq9** on a **shared storage layer**: one message written once, consumed by any protocol.\n\n![RobustMQ Architecture](docs/images/robustmq-architecture.jpg)\n\n```\nMQTT publish  →  RobustMQ unified storage  →  Kafka consume\n                                           →  NATS subscribe\n                                           →  AMQP consume\n                                           →  mq9 Agent mailbox\n```\n\n**Five protocols, one system:**\n\n| Protocol | Best for |\n|----------|---------|\n| **MQTT** | IoT devices, edge sensors |\n| **Kafka** | Streaming data pipelines, analytics |\n| **NATS** | Ultra-low-latency pub/sub |\n| **AMQP** | Enterprise messaging, RabbitMQ migration |\n| **mq9** | AI Agent async communication |\n\n## 🤖 mq9 — Agent Mailbox for AI\n\n**mq9** is RobustMQ's communication layer designed for AI Agents. Just like people have email — you send a message, the recipient reads it when they're available — Agents need the same. Today, when Agent A sends a message to Agent B and B is offline, the message is gone. Every team works around this with Redis pub/sub, database polling, or homegrown queues.\n\nmq9 solves it directly: **send a message, the recipient gets it when they come online.**\n\n\u003cdiv align=\"center\"\u003e\n\n| Primitive | What it does |\n|-----------|-------------|\n| **Mailbox** | Each Agent has its own inbox. Messages wait until the Agent comes online. |\n| **Broadcast** | Publish once, any interested Agent subscribes. No need to know who's listening. |\n| **Priority** | `urgent` / `normal` / `notify` — critical messages are never buried. |\n\n\u003c/div\u003e\n\n```bash\n# Give an Agent an identity and mailbox — one call, no registration\nnats req '$mq9.AI.MAILBOX.CREATE' '{}'\n# → {\"agent_id\": \"agt-uuid-001\", \"token\": \"tok-xxx\"}\n\n# Send to another Agent's mailbox (works even if they're offline)\nnats pub '$mq9.AI.INBOX.agt-uuid-002.normal' '{\"from\":\"agt-uuid-001\",\"payload\":\"task done\"}'\n\n# Broadcast an event — anyone interested will receive it\nnats pub '$mq9.AI.BROADCAST.task.available' '{\"task_id\":\"t-001\"}'\n\n# Subscribe to your own mailbox\nnats sub '$mq9.AI.INBOX.agt-uuid-001.*'\n```\n\n**Any NATS client — Go, Python, Rust, Java, JavaScript — is already an mq9 client.** No new SDK needed.\n\nmq9 is RobustMQ's fifth native protocol, alongside MQTT, Kafka, NATS, and AMQP, built on the same unified storage layer. Deploy one RobustMQ instance — mq9 is ready.\n\n\u003e 📖 [mq9 Documentation](https://robustmq.com/en/mq9/)\n\n---\n\n## ✨ Features\n\n\u003cdiv align=\"center\"\u003e\n  \u003cvideo src=\"https://robustmq.com/assets/demo.zRXM786t.mp4\" controls width=\"100%\"\u003e\u003c/video\u003e\n\u003c/div\u003e\n\n- 🤖 **mq9 — AI Agent communication**: Agent mailbox, broadcast, priority queue — async Agent-to-Agent messaging, no simultaneous online required\n- 🦀 **Rust-native**: No GC, stable and predictable memory footprint, no periodic spikes — consistent from edge devices to cloud clusters\n- 🗄️ **Unified storage layer**: All protocols share one storage engine — data written once, consumed by any protocol, no duplication\n- 🔌 **Native multi-protocol**: MQTT 3.1/3.1.1/5.0, Kafka, NATS, AMQP, mq9 — natively implemented, full protocol semantics\n- 🏢 **Native multi-tenancy**: Unified across all protocols — full data isolation and independent permission management per tenant\n- 🌐 **Edge-to-cloud**: Single binary, zero dependencies, offline buffering with auto-sync — same runtime from edge gateways to cloud clusters\n- ⚡ **Ultra-low-latency dispatch**: NATS pure in-memory routing — no disk writes, millisecond to sub-millisecond latency\n- 💾 **Multi-mode storage**: Memory / RocksDB / File, per-topic configuration, automatic cold data tiering to S3\n- 🔄 **Shared subscription**: Break the \"concurrency = partition count\" limit — consumers scale elastically at any time\n- 🛠️ **Minimal operations**: Single binary, zero external dependencies, built-in Raft consensus, ready out of the box\n\n## 🗺️ Roadmap\n\n```\nPhase 1 — MQTT (current)\n  MQTT core production-ready, continuously refined to be the best MQTT Broker available\n  Architecture and infrastructure hardened in parallel\n\nPhase 2 — NATS + mq9 AI Agent (in progress)\n  NATS protocol compatibility + mq9 Agent mailbox \u0026 broadcast\n  Native Agent async communication layer\n\nPhase 3 — Kafka (in progress)\n  Full Kafka protocol compatibility\n  Complete the IoT-to-streaming data path, edge-to-cloud data flow\n\nPhase 4 — AMQP (planned)\n  Full AMQP protocol compatibility\n  Traditional enterprise messaging migration path\n```\n\n| Feature | Status |\n|---------|--------|\n| MQTT 3.x / 5.0 core | ✅ Available |\n| Session persistence and recovery | ✅ Available |\n| Shared subscription | ✅ Available |\n| Authentication and ACL | ✅ Available |\n| Grafana + Prometheus monitoring | ✅ Available |\n| Web management console | ✅ Available |\n| Kafka protocol | 🚧 In development |\n| NATS protocol | 🔬 Demo validated, in development |\n| AMQP protocol | 🔬 Demo validated, in development |\n| mq9 — AI Agent mailbox | 🔬 Demo validated, in development |\n\n## 🏗️ Architecture\n\nRobustMQ has three components with fixed, clean boundaries:\n\n- **Meta Service** — metadata management, Raft-based consensus\n- **Broker** — protocol parsing and routing (MQTT / Kafka / NATS / AMQP / mq9)\n- **Storage Engine** — unified data storage with pluggable backends\n\nAdding a new protocol means implementing only the Broker parsing layer. Adding a new storage backend means implementing only the Storage Engine interface. The core architecture does not change.\n\n## 🚀 Quick Start\n\n### One-Line Installation\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/robustmq/robustmq/main/scripts/install.sh | bash\nbroker-server start\n```\n\n### Multi-Protocol in Action\n\n```bash\n# Publish via MQTT\nmqttx pub -h localhost -p 1883 -t \"robustmq.multi.protocol\" -m \"Hello RobustMQ!\"\n\n# Consume the same message via Kafka\nkafka-console-consumer.sh --bootstrap-server localhost:9092 \\\n  --topic robustmq.multi.protocol --from-beginning\n\n# Consume the same message via NATS\nnats sub \"robustmq.multi.protocol\"\n```\n\n### mq9 Agent Mailbox in Action\n\n```bash\n# Agent A gets a mailbox\nnats req '$mq9.AI.MAILBOX.CREATE' '{}'\n\n# Agent B sends to Agent A (even if A is offline)\nnats pub '$mq9.AI.INBOX.{agent_a_id}.normal' '{\"from\":\"agent-b\",\"payload\":\"hello\"}'\n\n# Agent A subscribes and receives\nnats sub '$mq9.AI.INBOX.{agent_a_id}.*'\n```\n\n### Web Dashboard\n\nAccess `http://localhost:8080` for cluster monitoring and management.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/images/web-ui.jpg\" alt=\"Web UI\" width=\"45%\" style=\"margin-right: 2%;\"\u003e\n  \u003cimg src=\"docs/images/web-ui-cluster.jpg\" alt=\"Web UI Cluster\" width=\"45%\"\u003e\n\u003c/div\u003e\n\n### Try Online Demo\n\n- **MQTT Server**: `117.72.92.117:1883` (admin/robustmq)\n- **Web Dashboard**: http://demo.robustmq.com:8080\n\n📚 **Full installation and usage guide: [Documentation](https://robustmq.com/)**\n\n## 🔧 Development\n\n```bash\ngit clone https://github.com/robustmq/robustmq.git\ncd robustmq\ncargo run --package cmd --bin broker-server\n\nmake build           # Basic build\nmake build-full      # With frontend\n```\n\n📚 **[Build Guide](https://robustmq.com/QuickGuide/Build-and-Package.html)**\n\n## 📚 Documentation\n\n- **📖 [Official Documentation](https://robustmq.com/)** — Comprehensive guides and API references\n- **🤖 [mq9 — AI Agent Communication](https://robustmq.com/en/mq9/)** — Agent mailbox, broadcast, priority queue\n- **🚀 [Quick Start Guide](https://robustmq.com/QuickGuide/Overview.html)** — Get up and running in minutes\n- **🔧 [MQTT Documentation](https://robustmq.com/RobustMQ-MQTT/Overview.html)** — MQTT-specific features and configuration\n- **💻 [Command Reference](https://robustmq.com/RobustMQ-Command/Mqtt-Broker.html)** — CLI commands and usage\n- **🎛️ [Web Console](https://github.com/robustmq/robustmq-copilot)** — Management interface\n\n## 🤝 Contributing\n\nWe welcome contributions. See our [Contribution Guide](https://robustmq.com/en/ContributionGuide/GitHub-Contribution-Guide.html) and [Good First Issues](https://github.com/robustmq/robustmq/labels/good%20first%20issue).\n\n## 🌐 Community\n\n- **🎮 [Discord](https://discord.gg/sygeGRh5)** — Real-time chat and collaboration\n- **🐛 [GitHub Issues](https://github.com/robustmq/robustmq/issues)** — Bug reports and feature requests\n- **💡 [GitHub Discussions](https://github.com/robustmq/robustmq/discussions)** — General discussions\n\n### 🇨🇳 Chinese Community\n\n- **微信群**: Join our WeChat group for Chinese-speaking users\n\n  \u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"docs/images/wechat-group.jpg\" alt=\"WeChat Group QR Code\" width=\"200\" /\u003e\n  \u003c/div\u003e\n\n- **开发者微信**: If the group QR code has expired, follow our official WeChat account\n\n  \u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"docs/images/wechat.jpg\" alt=\"WeChat Official Account QR Code\" width=\"200\" /\u003e\n  \u003c/div\u003e\n\n## License\n\nRobustMQ is licensed under the [Apache License 2.0](LICENSE). See [LICENSING.md](LICENSING.md) for details.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003csub\u003eBuilt with ❤️ by the RobustMQ team and \u003ca href=\"https://github.com/robustmq/robustmq/graphs/contributors\"\u003econtributors\u003c/a\u003e.\u003c/sub\u003e\n\u003c/div\u003e\n","funding_links":[],"categories":["Recently Updated","Applications"],"sub_categories":["[Sep 16, 2024](/content/2024/09/16/README.md)","Message Queue"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobustmq%2Frobustmq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobustmq%2Frobustmq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobustmq%2Frobustmq/lists"}