xiaomi/ha_xiaomi_home

Analysis updated 2026-05-18

★ 21,654PythonAudience · vibe coderComplexity · 2/5Setup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Connect Xiaomi devices
      Control from Home Assistant
      Create automations
      Monitor device status
    How it works
      Cloud control default
      Local control optional
      MIoT protocol
      Multiple accounts
    Setup
      Login with Xiaomi account
      Select homes and devices
      Import to Home Assistant
    Use cases
      Unified smart home control
      Cross-brand automations
      Single control panel
      Family device management

mindmap root((repo)) What it does Connect Xiaomi devices Control from Home Assistant Create automations Monitor device status How it works Cloud control default Local control optional MIoT protocol Multiple accounts Setup Login with Xiaomi account Select homes and devices Import to Home Assistant Use cases Unified smart home control Cross-brand automations Single control panel Family device management

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Control all your Xiaomi smart home devices from Home Assistant instead of the Xiaomi app.

USE CASE 2

Create automations that combine Xiaomi devices with smart devices from other brands.

USE CASE 3

Manage multiple Xiaomi accounts and homes in one unified dashboard for your family.

What is it built with?

PythonHome AssistantMIoT protocol

How does it compare?

	xiaomi/ha_xiaomi_home	recommenders-team/recommenders	graphdeco-inria/gaussian-splatting
Stars	21,654	21,669	21,673
Language	Python	Python	Python
Setup difficulty	moderate	moderate	hard
Complexity	2/5	3/5	4/5
Audience	vibe coder	researcher	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Home Assistant instance running and Xiaomi device credentials/pairing setup.

License could not be detected automatically. Check the repository's LICENSE file before use.

In plain English

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.

Copy-paste prompts

Prompt 1

How do I install the Xiaomi Home integration in Home Assistant and connect my Xiaomi devices?

Prompt 2

Show me how to set up local control for my Xiaomi devices in Home Assistant using a gateway.

Prompt 3

How can I create an automation in Home Assistant that triggers a Xiaomi device based on another brand's sensor?

Prompt 4

What Xiaomi devices are supported by this Home Assistant integration and how do I check compatibility?

Frequently asked questions

What is ha_xiaomi_home?

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

What language is ha_xiaomi_home written in?

Mainly Python. The stack also includes Python, Home Assistant, MIoT protocol.

What license does ha_xiaomi_home use?

License could not be detected automatically. Check the repository's LICENSE file before use.

How hard is ha_xiaomi_home to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ha_xiaomi_home for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub xiaomi on gitmyhub

Verify against the repo before relying on details.