Screenshots From the README of kingchddg901/Vacuum_Agent.
About
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
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.
Provides
- Switches
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.
Entities
- Binary sensorsActive Run Has Error
- NumbersMaintenance Interval, Order
- SensorsOnboarding 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
- SwitchesSelected for Cleaning, Clean Order Override
Troubleshooting
- DiagnosticsDownloads 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.
Shows in Vulpo
Quick Toggle card, Button card, Select card, Apple Watch, Control Center.Information
- Installs
- 204 sharing analytics
- GitHub stars
- 15
- Connection
- Works locally
- Upkeep
- Updated in the last 6 months
- Version
- v2.5.1,
- Category
- Appliances and cleaning, Cleaning
- Kind
- Marketplace integration
- Brand
- eufy
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
eufy_vacuum- Issues
- Report an issue
