gitmyhub

ha_xiaomi_home

Python ★ 22k updated 4mo ago

Xiaomi Home Integration for Home Assistant

Official Xiaomi integration for Home Assistant that lets you control Xiaomi smart home devices alongside other brands from one dashboard.

PythonHome AssistantMIoT protocolsetup: moderatecomplexity 2/5

Xiaomi Home Integration is an official add-on for Home Assistant, a popular open-source platform that lets people control their smart-home devices from one place. This integration lets you connect Xiaomi smart devices, such as lights, sensors, and other gadgets registered to your Xiaomi account, into Home Assistant so they all sit alongside whatever else you already control there. You install it by either cloning it from GitHub, downloading through HACS (a community store for Home Assistant add-ons), or copying files manually using Samba or FTPS. Once installed, you sign in with your Xiaomi account using OAuth 2.0, which means your password is never stored locally, and you pick which home and devices to import. The integration supports multiple Xiaomi accounts at once, and devices from different accounts can share the same room. Communication happens through Xiaomi Cloud over MQTT, so device updates arrive in near real time without constant polling. A partial local-control mode is possible either through a Xiaomi central hub gateway (mainland China only) or by enabling a LAN control option for Wi-Fi and Ethernet devices. You would use this if you already run Home Assistant and want your Xiaomi smart-home gear visible there. It works in mainland China, Europe, India, Russia, Singapore, and the USA. Bluetooth, infrared, and virtual devices are not supported. It is written in Python.

Where it fits