Plataforma de domótica de código abierto que funciona localmente y prioriza el control y la privacidad, a menudo en una Raspberry Pi o un servidor local.
91,7 mil+28 esta semana39 milPythonApache-2.0Actualizado hace 19 horas
Koenkk/zigbee2mqtt
Un puente que conecta dispositivos Zigbee para el hogar inteligente con MQTT y permite usarlos sin el hub o gateway del fabricante.
Alternativa open source a:Philips Hue Bridge
- Estrellas
- 15,755
- Forks
- 2,029
- Issues abiertos
- 487
- Último commit
- hace 3 días
¿Qué es?
Zigbee2MQTT se comunica directamente con un adaptador coordinador Zigbee y vuelve a publicar por MQTT los eventos y el estado de los dispositivos. Los usuarios pueden controlar luces, sensores, interruptores y otros dispositivos Zigbee mediante temas MQTT, lo que permite conectar hardware Zigbee a cualquier sistema de domótica que ya admita MQTT.
El proyecto está desarrollado en TypeScript y se ejecuta como servicio en un host con un adaptador Zigbee compatible. Está dividido en tres capas: zigbee-herdsman gestiona la comunicación con el adaptador, zigbee-herdsman-converters asigna los modelos de dispositivos a sus clústeres Zigbee y Zigbee2MQTT se encarga de traducir entre los mensajes Zigbee y MQTT. Incluye interfaces web para supervisar y configurar el sistema.
La compatibilidad con los dispositivos se mantiene mediante una lista publicada de hardware compatible, y es posible añadir dispositivos nuevos escribiendo código de conversión. Hay documentación sobre las integraciones oficiales con Home Assistant, Homey, Domoticz, Gladys Assistant e ioBroker.
Funciones clave
- 01Controla dispositivos Zigbee mediante la publicación y suscripción a temas MQTT.
- 02Funciona sin un puente o gateway Zigbee específico del fabricante.
- 03Incluye interfaces web para supervisar y configurar la red.
- 04Mantiene una lista pública de dispositivos compatibles de numerosos fabricantes.
- 05Ofrece integraciones documentadas con Home Assistant, Homey, Domoticz y otras plataformas.
Casos de uso
- Configurar un hogar inteligente local sin depender de hubs de fabricantes que solo funcionan con la nube.
- Enviar las lecturas de sensores Zigbee a un sistema de automatización existente basado en MQTT.
- Añadir a Home Assistant o a plataformas similares dispositivos Zigbee que el fabricante no admite.
Inicio rápido
- 1
Sigue la guía de inicio de la documentación oficial
Antes de usarlo
- Está bajo la licencia GPL-3.0, una licencia copyleft que exige que las obras derivadas se publiquen como código abierto bajo las mismas condiciones.
- No todos los dispositivos Zigbee son compatibles, por lo que quizá haya que añadir compatibilidad para los dispositivos que no aparecen en la lista.
Temas
Preguntas frecuentes
- ¿Qué es zigbee2mqtt?
- Un puente que conecta dispositivos Zigbee para el hogar inteligente con MQTT y permite usarlos sin el hub o gateway del fabricante. Zigbee2MQTT se comunica directamente con un adaptador coordinador Zigbee y vuelve a publicar por MQTT los eventos y el estado de los dispositivos. Los usuarios pueden controlar luces, sensores, interruptores y otros dispositivos Zigbee mediante temas MQTT, lo que permite conectar hardware Zigbee a cualquier sistema de domótica que ya admita MQTT.
- ¿zigbee2mqtt es gratuito? ¿Qué licencia tiene?
- zigbee2mqtt es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿zigbee2mqtt sigue mantenido?
- Mantenimiento activo. El último commit de zigbee2mqtt fue el 21 oct 2026.
- ¿Para qué puedo usar zigbee2mqtt?
- Configurar un hogar inteligente local sin depender de hubs de fabricantes que solo funcionan con la nube. Enviar las lecturas de sensores Zigbee a un sistema de automatización existente basado en MQTT. Añadir a Home Assistant o a plataformas similares dispositivos Zigbee que el fabricante no admite.
- ¿Cómo se instala zigbee2mqtt?
- Sigue la guía de inicio de la documentación oficial
- ¿Dónde consigo zigbee2mqtt?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Koenkk/zigbee2mqtt
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Sistema basado en configuración que convierte microcontroladores ESP32, ESP8266, BK72xx y RP2040 en dispositivos inteligentes controlados desde Home Assistant y otros sistemas de domótica.
11,9 mil5,7 milC++OtherActualizado hace 19 horas
Controlador de carga para vehículos eléctricos y gestor energético doméstico de código abierto que optimiza la carga de wallboxes con datos solares y de baterías, sin servicios en la nube.
7,4 mil+4 esta semana1,6 milGoMITActualizado hace 20 horas
Integración oficial de Xiaomi que incorpora dispositivos inteligentes Xiaomi IoT a Home Assistant mediante Xiaomi Cloud o una pasarela central local.
22,2 mil1,2 milPythonOtherActualizado hace 26 días
Plataforma autohospedada de integración de video para el hogar y NVR, con detecciones inteligentes y transmisión de cámaras a HomeKit, Google Home y Alexa.
6 mil406TypeScriptOtherActualizado hace 6 días
Biblioteca Python y herramienta de línea de comandos miiocli para controlar dispositivos Xiaomi de hogar inteligente mediante los protocolos miIO y MIoT.
4,3 mil601PythonGPL-3.0Actualizado hace 3 meses