# Tasshack/dreame-vacuum

Home Assistant integration for Dreame robot vacuums with map support

Repository: https://github.com/Tasshack/dreame-vacuum
Canonical: https://ross.abutalabs.com/products/dreame-vacuum
Homepage: https://community.home-assistant.io/t/custom-component-dreame-vacuum
Language: Python
License: MIT
License Family: permissive
Topics: app, automation, cloud, dreame, hacs, home-assistant, map, mi-home, miio, robot, vacuum, vacuum-map, xiaomi, dreametech, homeassistant, integration, dreamehome, home-assistant-custom-component
Last push: 2026-06-21T01:41:36+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 88, release rhythm 77, longevity 100
- inputs: {"age_days": 1431, "days_push": 74, "days_rel": 74, "gap_med": 71.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2155, forks 269 (observed 2026-08-28T04:06:19.539884+00:00)

## What it is
A Home Assistant custom integration (HACS-installable) that replaces the Mi Home/Dreamehome app for Dreame robot vacuums, exposing device entities, services, and automations. It decodes and renders live and multi-floor vacuum maps with room entities and Valetudo map card support.

## Use cases
- control my Dreame robot vacuum from Home Assistant without the Mi Home app
- render live vacuum maps in Home Assistant dashboards
- create automations for room-specific cleaning
- get persistent notifications and error reports from my vacuum
- support multi-floor maps for a robot vacuum
- replace the Dreamehome app with local Home Assistant entities

## When to choose
- you own a supported Dreame robot vacuum model and use Home Assistant
- you want map rendering, room cleaning entities, and app-level features inside Home Assistant
- you want Valetudo map card compatibility without flashing custom firmware

## When to avoid
- your vacuum brand or model is not in the supported Dreame device list
- you don't run Home Assistant
- you need a fully cloud-free, flashed-firmware solution like Valetudo

## Facets
- artifact type: plugin
- maturity: active
- function: iot, workflow-automation, monitoring, plugin-system
- domain: iot, self-hosted
- platform: python, self-hosted
- tags: home-assistant, hacs, dreame, xiaomi, robot-vacuum, miio, map-rendering, custom-component, vacuum-control, home-automation, automation, docker

## Member repositories
- Tasshack/dreame-vacuum (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:19.539884+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:50:35.947866+00:00, confidence not recorded.
  - readme: https://github.com/Tasshack/dreame-vacuum (fetched 2026-08-28T04:06:19.539884+00:00, sha 9750f9aa3cfc)
  - homepage: https://community.home-assistant.io/t/custom-component-dreame-vacuum (fetched 2026-08-29T10:30:35.253560+00:00, sha 3a552855a77a)
  - site_page: https://community.home-assistant.io/t/valetudo-map-card-installation-instructions/247329/26 (fetched 2026-08-29T10:30:35.264592+00:00, sha 06e4432cf149)
  - site_page: https://community.home-assistant.io/c/projects/custom-integrations/47 (fetched 2026-08-29T10:30:35.262810+00:00, sha 96b68137ddcb)
- Data as of 2026-08-30T08:39:29.467469+00:00.