--- title: "Vacuum Agent" description: "Vacuum Agent is a Marketplace integration for Home Assistant. It has 204 installs sharing analytics, works locally and was last updated October 27, 2026." canonical: "https://vulpo.app/integrations/marketplace/kingchddg901-vacuum-agent" url: "https://vulpo.app/integrations/marketplace/kingchddg901-vacuum-agent.md" last-updated: "2026-10-27" version: "1.4" --- # Vacuum Agent > Vacuum Agent is a Marketplace integration for Home Assistant. It has 204 installs sharing analytics, works locally and was last updated October 27, 2026. Vacuum Agent is an integration that adds room-level cleaning, a live map and cleaning estimates for Eufy, Roborock and Dreame robot vacuums. It builds on the existing vacuum integration for each brand rather than replacing it, and works locally. Rooms can be selected by name and queued, and a box drawn on the map can be cleaned or saved as a named zone filed under a room. Run profiles and per-room rules store vacuum settings and conditions, and a learning system records how long each room takes to estimate completion time. Battery health tracking covers charge cycles, charge rate and drain per job, and events such as stall detection can feed automations. It is set up in the UI and needs the Marketplace. Automatic summary of the README and code of kingchddg901/Vacuum\_Agent. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=kingchddg901&repository=Vacuum_Agent&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=kingchddg901&repository=Vacuum_Agent&category=integration) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Set up Vacuum Agent - **Tested model** - **Notes** - **Vacuum** ### After setup - **Vacuum** - **Notes** - **Task status sensor** - **Work mode sensor** - **Dock status sensor** - **Active map sensor** - **Active cleaning target sensor** - **Cleaning area sensor (this run, not the lifetime total)** - **Cleaning time sensor (this run, not the lifetime total)** - **Water level entity** - **Cleaning intensity select** - **Robot position X sensor** - **Robot position Y sensor** - **Wash mop button** - **Dry mop button** Texts from the code of [kingchddg901/Vacuum\_Agent](https://github.com/kingchddg901/Vacuum_Agent). ## Entities - **Binary sensors**: Active Run Has Error - **Numbers**: Maintenance Interval, Order - **Sensors**: Onboarding State, Map Overlays, Dock Events, Theme State, Available Profiles, Active Job, Active Run Error, Last Device Error, Charge Cycles, Charge Rate, Charge Rate (Low Zone), Charge Rate (High Zone), and 12 more - **Switches**: Selected for Cleaning, Clean Order Override ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. ## From the README > A custom Home Assistant integration that adds a whole control-and-intelligence layer on top of your robot vacuum — room-level cleaning, a live map you can actually drive from, a learning/ETA system, saved zones, battery-health tracking, a themeable dashboard, eighteen languages, and automation events — for Eufy, Roborock and Dreame. It uses an adapter pattern, so more brands can follow. > > Every room painted with its real floor material — wood, marble, granite, tile, carpet — rendered live over your robot's actual map. From the README of [kingchddg901/Vacuum\_Agent](https://github.com/kingchddg901/Vacuum_Agent#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Appliances and cleaning](https://vulpo.app/integrations/category/appliances-and-cleaning.md), Cleaning - Brand: [eufy](https://vulpo.app/integrations/eufy.md) - Number: 204 installs sharing analytics; 15 GitHub stars - Connection: Works locally - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.5.1, last updated October 27, 2026 - Domain: `eufy_vacuum` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/97c745efeb5f25c9.webp (from kingchddg901/Vacuum\_Agent's README) - Screenshot: https://vulpo.app/integrations-img/4102ea022b42ace4.webp (from kingchddg901/Vacuum\_Agent's README) - Screenshot: https://vulpo.app/integrations-img/03b4d395080e1b5f.webp (from kingchddg901/Vacuum\_Agent's README) In Vulpo: Quick Toggle card, Button card, Select card, Apple Watch, Control Center ## Other ways in for eufy | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Eufy Security](https://vulpo.app/integrations/marketplace/fuatakgun-eufy-security.md) | Marketplace integration | 9.8k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Eufy Robovac MQTT](https://vulpo.app/integrations/marketplace/jeppesens-eufy-clean.md) | Marketplace integration | 1.7k installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months | | [Eufy Robovac](https://vulpo.app/integrations/marketplace/damacus-robovac.md) | Marketplace integration | 1.6k installs sharing analytics | Works locally | Updated in the last 6 months | | [EufyLife](https://vulpo.app/integrations/core/eufylife-ble.md) | Built-in integration | 1.6k installs sharing analytics | Works locally | Part of Home Assistant | | [EufyHome](https://vulpo.app/integrations/core/eufy.md) | Built-in integration | 150 installs sharing analytics | Works locally | Part of Home Assistant | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-27. Source: https://vulpo.app/integrations/marketplace/kingchddg901-vacuum-agent --- - HTML version of this page: https://vulpo.app/integrations/marketplace/kingchddg901-vacuum-agent - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml