How to Install Xiaomi’s Official Home Assistant Integration and Boost Your Smart Home

While browsing GitHub Trending, the author discovered the Xiaomi open‑source project ha_xiaomi_home (Xiaomi Home Integration for Home Assistant), which enables Home Assistant to control Xiaomi IoT devices.

Home Assistant is an open‑source home‑automation platform that unifies smart devices from various vendors, allowing users to create automation scenes and manage devices such as lights, cameras, sensors, and switches.

The Xiaomi integration provides official support, including OAuth 2.0 login, improving performance and security compared with existing third‑party integrations.

Installation can be done in several ways, but the official recommendation is to clone the repository directly.

cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

To update to a specific version, switch to the desired tag and reinstall:

cd config/ha_xiaomi_home
git checkout v1.0.0
./install.sh /config

After installation, add the integration in Home Assistant’s Settings and log in with a Xiaomi account.

The integration stores OAuth tokens and device information in Home Assistant’s configuration files in plain text, so users should protect these files to avoid credential leakage.

Compared with community‑made integrations, the official Xiaomi component offers better performance and security, though users must be aware of the plain‑text storage limitation.