mqttasgi
بواسطة sivulich
DevOps & Cloudموجز
MQTT ASGI protocol server for Django — bridge MQTT messages to Django Channels consumers with full ORM, Channel.
الوصف
ما الذي تفعله هذه المهارة
mqttasgi is an ASGI protocol server that connects MQTT brokers to Django Channels consumers. It lets Django handle MQTT messages directly, with access to the ORM, Channel Layers, and async consumer patterns. Built on paho-mqtt, it runs alongside a standard Django Channels setup.
It lets Django developers handle MQTT in the same consumer pattern as HTTP and WebSocket, reusing ORM, Channel Layers, and middleware without running a separate service.
متى تستخدمها
- Receiving IoT sensor readings and storing them in a Django database
- Triggering home automation actions based on MQTT device messages
- Publishing real-time alerts when sensor values exceed configured thresholds
- Coordinating multiple IoT devices using per-device worker consumers
- Testing MQTT consumers in CI without a running broker
مثال على سير العمل
User asks: Store energy sensor readings in Django and publish an alert when consumption is too high
- 1
Define EnergyMonitorConsumer extending MqttConsumer
- 2
Subscribe to 'home/energy/consumption' in the connect handler
- 3
Parse the incoming payload and save an EnergyReading record via the Django ORM
- 4
Check if watts exceed the threshold and publish to 'home/alerts/energy' if so
Energy readings are persisted in Django and high-consumption alerts are published to the MQTT alert topic in real time
المتطلبات
- Running MQTT broker (e.g., Mosquitto, HiveMQ, or a cloud MQTT service)
التثبيت
clawhub install sivulich/mqttasgiشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.