Tasshack/dreame-vacuum

Home Assistant integration for Dreame robot vacuums with map support

Python

2,230

73 commits

updated Oct 11, 2026

dreame-vacuum.tasshack.com

See the code

README

Complete app replacement with Home Assistant for Dreame robot vacuums.

Features

Wide range of Dreame, MOVA, Mijia and Trouver robot vacuums and mops, configurable with a DreameHome, MovaHome, Xiaomi Home account or fully locally without the cloud
Almost every setting and state exposed dynamically as auto generated entities
Live and multi-floor map support with zone, spot and room cleaning
Per-room suction, water volume and cleaning order for customized cleaning
Persistent notifications and events for automations
Cleaning/cruising history, obstacle photos, map backup & recovery and saved WiFi maps
Backend translations for 40 languages
Complete interactive map editor via embedded Dreame Vacuum Card

Documentation

Installation - Minimum Home Assistant version and hardware requirements, with HACS and manual setup steps
Configuration - Adding the device with a Dreamehome, Xiaomi Home, MOVAhome or TROUVER account, or locally over the LAN
Configuration Options - Per device settings offered during setup and from the Configure button
Supported Devices - Model codes of every tested Dreame, MOVA, Mijia and TROUVER robot with the features it exposes
How to Use - How entities, services and events come together on a dashboard
Dashboard - Setup examples and YAML templates for every supported Lovelace card, including the built-in Dreame Vacuum Card
Entities - What gets generated for a device, with map, room and consumable entities covered separately
Map Support - How map data is decoded and rendered, with history, recovery, obstacle photos and WiFi maps
Services - Parameters and automation examples for device and map control
Notifications - Which device events raise a persistent notification and how to turn them off
Events - Event types fired on the bus and the payloads they carry
FAQ - Recurring questions from the issue tracker and their actual causes

Thanks To

xiaomi_vacuum by @pooyashahidi
Xiaomi MIoT for Home Assistant by @ha0y
Xiaomi Cloud Map Extractor by @PiotrMachowski
Dreame cloud authentication by @kuudori
Mova cloud support by @r1si

dreame

dreamehome

dreametech

hacs

home-assistant

homeassistant

home-assistant-custom-component

integration

lovelace

lovelace-card

map

mi-home

miio

mova

movahome

robot

vacuum

vacuum-map

xiaomi

xiaomi-home

Significant stargazers

(top 24 of 25)

Sandro

609 followers · starred Oct 2026

Thibault Duplessis

6,499 followers · starred Jul 2023

Lenz Weber-Tronic

865 followers · starred May 2023

Timothy Sutton

705 followers · starred Jul 2026

Similar repos

al-one/hass-xiaomi-miot

Automatic integrate all Xiaomi devices to HomeAssistant via miot-spec, support Wi-Fi, BLE, ZigBee…

6,167

XiaoMi/ha_xiaomi_home

Xiaomi Home Integration for Home Assistant

22,189

Python-roborock/local_roborock_server

Local HTTPS and MQTT cloud emulator for Roborock vacuums without rooting or hardware modifications

908

georgezhao2010/midea_ac_lan

Auto-configure and then control your Midea M-Smart devices (Air conditioner, Fan, Water heater,…

1,827

rytilahti/python-miio

Python library & console tool for controlling Xiaomi smart appliances

4,317

RiDDiX/home-assistant-matter-hub

Publish your Home-Assistant Instance using Matter.

1,282

rospogrigio/localtuya

local handling for Tuya devices

3,994

PiotrMachowski/Xiaomi-cloud-tokens-extractor

This tool retrieves tokens for all devices connected to Xiaomi cloud and encryption keys for BLE…

4,844