用于通过 miIO 和 MIoT 协议控制小米智能家居设备的 Python 库及命令行工具。
4331601PythonGPL-3.0更新于 3个月前
- Star
- 22,240
- Fork
- 1,193
- 未关闭 Issue
- 157
- 最近提交
- 26天前
这是什么？
Xiaomi Home Integration 是由小米官方维护的 Home Assistant 自定义集成，用于将米家 IoT 设备接入 Home Assistant。用户使用小米账号通过 OAuth 2.0 登录，选择家庭后，其中的设备会以实体形式出现在 Home Assistant 中。
设备依据 MIoT-Spec-V2 规范转换为实体：可写属性映射为开关、数值、选择或文本实体，只读属性映射为传感器，事件转为 Event 实体，动作则转为按钮或通知实体。实体转换规则可通过本地的 spec_filter 和多语言文件自定义。同一个 Home Assistant 实例可以添加多个小米账号。
默认通过小米云端控制设备。若存在小米中枢网关或内置中枢网关功能的设备，则可在本地通过 MQTT 进行控制和状态同步。项目还提供局域网控制选项，可控制部分联网设备，但官方不推荐使用。
核心功能
- 01登录小米账号后将米家 IoT 设备导入 Home Assistant
- 02将 MIoT-Spec-V2 的属性、事件和动作映射为 Home Assistant 实体
- 03通过小米中枢网关或内置中枢网关的设备支持本地控制
- 04同一实例可添加多个小米账号和不同地区的设备
- 05提供 13 种界面语言，并支持自定义实体转换规则
适用场景
- 在 Home Assistant 面板中控制小米灯具、插座和传感器
- 将小米设备与其他品牌智能家居设备组合成自动化场景
- 在中国大陆使用小米中枢网关实现以本地控制为主的方案
标签
常见问题
- ha_xiaomi_home 是什么？
- 小米官方提供的 Home Assistant 集成，可将米家智能设备接入 Home Assistant。 Xiaomi Home Integration 是由小米官方维护的 Home Assistant 自定义集成，用于将米家 IoT 设备接入 Home Assistant。用户使用小米账号通过 OAuth 2.0 登录，选择家庭后，其中的设备会以实体形式出现在 Home Assistant 中。
- ha_xiaomi_home 可以免费使用吗？用的什么许可证？
- ha_xiaomi_home 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。
- ha_xiaomi_home 还在维护吗？
- 活跃维护中。ha_xiaomi_home 最近一次提交是在 2026年9月28日。
- ha_xiaomi_home 适合用来做什么？
- 在 Home Assistant 面板中控制小米灯具、插座和传感器 将小米设备与其他品牌智能家居设备组合成自动化场景 在中国大陆使用小米中枢网关实现以本地控制为主的方案
- 在哪里获取 ha_xiaomi_home？
- 源代码和安装说明在 GitHub 上：https://github.com/XiaoMi/ha_xiaomi_home
概要由 AI 根据项目 README 生成；GitHub 数据每日更新。
相关项目
基于 mijiaAPI 的米家设备 Windows 桌面控制端，提供图形界面、托盘与桌面挂件。
167+10 本周15PythonGPL-3.0更新于 昨天
菜单栏与 iPhone 应用，以实时 3D 模型展示家居，并通过智能生活、Home Assistant、Hue 和 Apple Home 控制灯光与空调。
738+16 本周102SwiftMIT更新于 前天
注重本地控制与隐私的开源智能家居自动化平台，可运行在树莓派或本地服务器上。
9.2万+28 本周3.9万PythonApache-2.0更新于 18小时前
将 Zigbee 智能设备接入 MQTT 的桥接工具，无需厂商网关即可使用设备。
1.6万2029TypeScriptGPL-3.0更新于 3天前
基于 ESP32 的开源固件，可通过 WiFi 控制可寻址 RGB LED 灯带、2D 矩阵和 HUB75 面板。
1.9万4418C++EUPL-1.2更新于 21小时前