Skip to content
Back to search

iot-dc3

IoT DC3 — Connect the Physical World to AI. An open-source Industrial IoT Runtime for Physical AI: 36 protocol drivers, edge-to-cloud data delivery, and an MCP tool gateway so AI agents act on devices in a safe, controllable, traceable loop.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pnoker--iot-dc3/badge.svg)](/listings/pnoker--iot-dc3)

HTML

<a href="/listings/pnoker--iot-dc3"><img src="/api/listings/pnoker--iot-dc3/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

For source-based local development, start PostgreSQL and RabbitMQ, load local environment variables, then build:

make up-db
source dc3/env/dev.env.sh
mvn -s .mvn/settings.xml clean package

Use `make up-db-cn` if you prefer the Alibaba Cloud registry in Mainland China.

> 📖 For service startup order, IDE setup, verification commands, and common pitfalls, > see the [full Quickstart](https://docs.dc3.site/en/quickstart/).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 241 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="right">
  2. <a href="./README.md">English</a> | <a href="./README.zh.md">中文</a> | <a href="./README.ja.md">日本語</a> | <a href="./README.vi.md">Tiếng Việt</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.es.md">Español</a> | <a href="./README.ru.md">Русский</a>
  3. </p>
  4. > **AI assistants:** Read [README.ai.md](./README.ai.md) first for a concise, AI-friendly overview of IoT DC3.
  5. <p align="center">
  6. <img src="./.github/brand/png/banner.en.png" alt="IoT DC3 — Connect the Physical World to AI · Open-source Industrial IoT Runtime for Physical AI">
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/pnoker/iot-dc3/stargazers">
  10. <img src="https://img.shields.io/github/stars/pnoker/iot-dc3?style=flat&logo=github&color=green" alt="GitHub Stars">
  11. </a>
  12. <a href="https://gitee.com/pnoker/iot-dc3/stargazers">
  13. <img src="https://gitee.com/pnoker/iot-dc3/badge/star.svg?theme=gvp" alt="Gitee Star">
  14. </a>
  15. <a href="https://gitee.com/pnoker/iot-dc3/members">
  16. <img src="https://gitee.com/pnoker/iot-dc3/badge/fork.svg?theme=gvp" alt="Gitee Fork">
  17. </a>
  18. <a href="https://github.com/pnoker/iot-dc3/graphs/contributors">
  19. <img src="https://img.shields.io/github/contributors/pnoker/iot-dc3?label=contributors&color=orange" alt="Contributors">
  20. </a>
  21. <img src="https://img.shields.io/badge/License-AGPL%203.0-blue" alt="License">
  22. <img src="https://img.shields.io/badge/Java-21-orange?logo=openjdk" alt="Java 21">
  23. <img src="https://img.shields.io/badge/Spring%20Boot-4.1-6DB33F?logo=springboot" alt="Spring Boot 4.1">
  24. </p>
  25. <p align="center">
  26. <strong>
  27. IoT DC3 — Connect the Physical World to AI<br>
  28. An open-source Industrial IoT Runtime for Physical AI
  29. </strong>
  30. </p>
  31. <p align="center">
  32. <a href="https://dc3.site">https://dc3.site</a>
  33. </p>
  34. <p align="center">
  35. 🔌 <strong>Multi-protocol connectivity</strong> &nbsp;·&nbsp;
  36. 🤖 <strong>MCP tool gateway</strong> &nbsp;·&nbsp;
  37. ☁️ <strong>Cloud-native microservices</strong>
  38. </p>
  39. <p align="center">
  40. <em>
  41. IoT DC3 decouples <strong>devices</strong> from <strong>applications</strong>: drivers push normalized point data
  42. into a message bus, and applications consume it through one unified API — add or change devices without touching
  43. applications, and build new applications without touching devices.
  44. </em>
  45. </p>
  46. ---
  47. ## 📸 Product Preview
  48. <table>
  49. <tr>
  50. <th width="33%">📸 Platform Overview</th>
  51. <th width="33%">📸 Device Management</th>
  52. <th width="33%">📸 AI Agent</th>
  53. </tr>
  54. <tr>
  55. <td align="center">
  56. <img src="https://docs.dc3.site/images/screenshot-overview.png" alt="Platform dashboard" width="100%">
  57. <br>
  58. <strong>Home / Dashboard</strong><br>
  59. <em>System overview · Online device metrics · Data trend charts</em>
  60. </td>
  61. <td align="center">
  62. <img src="https://docs.dc3.site/images/screenshot-device.png" alt="Device management page" width="100%">
  63. <br>
  64. <strong>Device Management</strong><br>
  65. <em>Device list · Online status · Search and filtering</em>
  66. </td>
  67. <td align="center">
  68. <img src="https://docs.dc3.site/images/screenshot-ai.png" alt="AI agent assistant page" width="100%">
  69. <br>
  70. <strong>AI Agent Assistant</strong><br>
  71. <em>Natural-language device queries · Data insights · Governed execution</em>
  72. </td>
  73. </tr>
  74. </table>
  75. ## 🏗️ Architecture Overview
  76. ### Architecture at a Glance
  77. ![IoT DC3 Architecture Panorama](https://docs.dc3.site/images/architecture-panorama-en.png)
  78. Six-layer microservice architecture at a glance: clients → gateway → four center services → message bus → 36 protocol
  79. drivers → field devices. PostgreSQL (TimescaleDB + pgvector + AGE) persistence and optional observability stack (ELK +
  80. Prometheus + Grafana) laid out in one view.
  81. 🧱 **Design principles** — cross-service calls always go through Facade interfaces; the DO/BO/VO three-tier model keeps
  82. persistence, business, and API shapes strictly separated; and tenant isolation runs end to end across database, cache,
  83. and API paths. Clear boundaries that scale across services and teams.
  84. > 📖 For the full architecture documentation,
  85. > see [System Architecture Overview](https://docs.dc3.site/en/architecture/).
  86. ## ✨ Core Features
  87. ### 🔌 Multi-Protocol Device Connectivity
  88. IoT DC3 includes **36 access driver modules** for industrial automation, IoT communication, data bridging, basic
  89. communication, and simulation/debugging scenarios, reducing the cost of connecting common devices and data sources:
  90. | Category | Driver Modules |
  91. |-----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  92. | 🏭 **Industrial protocols** | Modbus TCP · Modbus RTU · OPC UA · OPC DA · Siemens S7 · BACnet/IP · EtherNet/IP · Omron FINS · Mitsubishi MELSEC · IEC 60870-5-104 · IEC 61850 · DNP3 · DLMS · DLT645 · KNX · M-Bus · SL651 |
  93. | 📡 **IoT protocols** | MQTT · CoAP · LwM2M · HTTP · BLE · Zigbee · LoRaWAN |
  94. | 🗄️ **Data bridging** | MySQL · PostgreSQL · Oracle · SQL Server · Redis |
  95. | 🔧 **Basic communication, messaging and NMS** | TCP/UDP · Serial · SNMP · CAN · Kafka |
  96. | 🧪 **Simulation and debugging** | Virtual · Listening Virtual |
  97. The **Driver SDK** supports fast development of custom protocol drivers and registration into the runtime platform.
  98. ### 🤖 From Device Data to Physical AI
  99. The Agentic Center is built on **Spring AI**, and the platform exposes an MCP tool gateway so AI agents can act on the
  100. physical world in one **safe, controllable, traceable loop**:
  101. - **MCP tool gateway** — external AI agents connect through the Model Context Protocol: OAuth client registration,
  102. per-tool authorization, and a full audit trail for every tool call
  103. - **Natural-language assisted operations** - through Tool Calling and under access control, LLMs can query devices,
  104. read/write points, and assist with command execution
  105. - **Intelligent alarm analysis** - AI assists with root-cause analysis and response suggestions
  106. - **Data insights** - Query device data in natural language and generate visual charts
  107. - **Multi-model support** - Compatible with OpenAI API-style providers and mainstream models such as GPT, Claude,
  108. DeepSeek, and Qwen
  109. - **Conversation memory** - Multi-turn conversations and context memory persisted to the database
  110. ### 🏗️ Cloud-Native Microservices
  111. Distributed microservice architecture based on **Spring Boot 4 + Spring Cloud 2025**:
  112. - **Service governance** - Spring Cloud Gateway as the unified entrypoint, with static routes and flexible environment
  113. variables
  114. - **Efficient communication** - gRPC service calls with Protobuf serialization
  115. - **Horizontal scaling** - Stateless design for scaling individual services by workload
  116. - **Resilience** - Replaceable service nodes and fault isolation
  117. ### 📊 Real-Time Data Engine
  118. - **Data collection** - Drivers collect device telemetry and send it asynchronously through the internal message
  119. broker — pluggable per deployment: RabbitMQ (default), Kafka, Pulsar or any MQTT 5 broker
  120. - **Time-series storage** - Efficient queries for real-time and historical data
  121. - **Rule engine** - Flexible alarm rules with multi-level alarms and notifications
  122. - **Event traceability** - Full command and event history
  123. ### 🔐 Enterprise Security and Multi-Tenancy
  124. - **Tenant isolation** - Tenant-level isolation across database, cache, and API paths
  125. - **Authentication and authorization** - JWT + Spring Security with RBAC
  126. - **Transport encryption** - TLS/SSL communication support
  127. - **Audit tracking** - User operation and system event logs
  128. ### 🧩 Developer Friendly
  129. - **Driver SDK** - A complete driver development toolkit. See
  130. the [Driver Authoring Guide](https://docs.dc3.site/en/development/driver-authoring)
  131. - **Separated frontend and backend** - Vue 3 + TypeScript frontend, RESTful and gRPC APIs
  132. - **Containerized deployment** - One-command startup with Podman / Docker Compose, plus compose scaling, Docker Swarm,
  133. Kubernetes and Helm deployment configs. See the [Deployment Guide](dc3/doc/DEPLOYMENT.md).
  134. - **Complete documentation** - Online docs, quickstart guide, and troubleshooting guide
  135. ## ⚡ Quick Start
  136. For source-based local development, start PostgreSQL and RabbitMQ, load local environment variables, then build:
  137. ```bash
  138. make up-db
  139. source dc3/env/dev.env.sh
  140. mvn -s .mvn/settings.xml clean package
  141. ```
  142. Use `make up-db-cn` if you prefer the Alibaba Cloud registry in Mainland China.
  143. > 📖 For service startup order, IDE setup, verification commands, and common pitfalls,
  144. > see the [full Quickstart](https://docs.dc3.site/en/quickstart/).
  145. ## 🛠️ Technology Stack
  146. IoT DC3 is built on Java 21, Spring Boot 4, Spring Cloud 2025, Spring AI 2, PostgreSQL, a pluggable message broker
  147. (RabbitMQ, Kafka, Pulsar or MQTT 5), gRPC, Vue 3,
  148. TypeScript, and Vite.
  149. See [Technology Stack](https://docs.dc3.site/en/development/technology-stack) for component details and where each
  150. technology is used.
  151. ## 📖 Documentation and Community
  152. | Resource | Link |
  153. |-----------------------|---------------------------------------------------------------------------------|
  154. | 📚 Online docs | [docs.dc3.site](https://docs.dc3.site/) |
  155. | 🎬 Live demo | [demo.dc3.site](https://demo.dc3.site/) |
  156. | 🏭 Industry demos | [dc3.site/en/demo](https://dc3.site/en/demo/) |
  157. | 🚀 Quickstart | [Quickstart Guide](https://docs.dc3.site/en/quickstart/) |
  158. | 🛠️ Technology stack | [Technology Stack](https://docs.dc3.site/en/development/technology-stack) |
  159. | 🏗️ Architecture | [Modules and Dependencies](https://docs.dc3.site/en/architecture/modules) |
  160. | 🔧 Driver development | [Driver Authoring Guide](https://docs.dc3.site/en/development/driver-authoring) |
  161. | 🐛 Troubleshooting | [Troubleshooting](https://docs.dc3.site/en/guide/troubleshooting) |
  162. | 📋 Changelog | [Release Changelog](https://docs.dc3.site/en/development/changelog) |
  163. | 💰 Pricing & licensing | [Plans and commercial license](https://dc3.site/en/pricing/) |
  164. | 🐛 Issue feedback | [GitHub Issues](https://github.com/pnoker/iot-dc3/issues) |
  165. | 🇨🇳 Gitee mirror | [Gitee GVP Project](https://gitee.com/pnoker/iot-dc3) |
  166. ## 🌍 Use Cases
  167. Twelve illustrative industry dashboards — built on IoT DC3 with mock data — show how the platform lands in each
  168. scenario. [Browse all demos](https://dc3.site/en/demo/).
  169. | | | |
  170. |--------------------|--------------------------------------------------------------|--------------------------------------------------------|
  171. | 🏭 [Smart Factory](https://dc3.site/en/demo/smart-factory/) — OEE monitoring | 💧 [Water Network](https://dc3.site/en/demo/water-network/) — digital twin | ⚡ [Microgrid](https://dc3.site/en/demo/microgrid/) — solar-storage balance |
  172. | 🌾 [Precision Agriculture](https://dc3.site/en/demo/precision-agri/) — greenhouse climate | 🏢 [Smart Building](https://dc3.site/en/demo/smart-building/) — HVAC and occupancy | 🚦 [Smart Traffic](https://dc3.site/en/demo/smart-traffic/) — congestion and signals |
  173. | 🛢️ [Oil & Gas Pipeline](https://dc3.site/en/demo/oil-gas/) — line pressure | ⛏️ [Smart Mine](https://dc3.site/en/demo/smart-mine/) — gas and ventilation | ❄️ [Cold Chain](https://dc3.site/en/demo/cold-chain/) — temperature traceability |
  174. | 🌿 [Environmental Monitoring](https://dc3.site/en/demo/eco-monitor/) — air and water quality | ⚓ [Smart Port](https://dc3.site/en/demo/smart-port/) — berth and yard scheduling | 🔌 [EV Charging](https://dc3.site/en/demo/ev-charging/) — load and storage synergy |
  175. ## 🤝 Contributing
  176. Contributions of all kinds are welcome. Please follow this workflow:
  177. 1. **Fork and branch** - Create a branch from `main`, using the format `feature/your_name/feature_description`
  178. (for example: `feature/pnoker/mqtt_driver`)
  179. 2. **Develop and commit** - Complete your changes on the new branch and follow
  180. the [Conventional Commits](https://www.conventionalcommits.org/) specification
  181. 3. **Open a PR** - Submit a Pull Request to the `develop` branch for maintainer review and merge
  182. ## 📄 License
  183. IoT DC3 is open source under the [AGPL 3.0](./LICENSE-AGPL.txt) license.
  184. - ✅ **Personal learning, research, and internal use** - Free
  185. - ✅ **Modify the code and open source your changes** - Welcome
  186. - ⚠️ **Offering it as a commercial service to third parties without open-sourcing modifications** - Requires a
  187. commercial license
  188. For commercial licensing details, see [LICENSE.txt](./LICENSE.txt).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.