deebot-client
Deebot client library in python 3
Decision gist · record as of 2026-08-14
Yes, if you own a Deebot vacuum and want programmatic control for home automation. The library is actively maintained, has no known vulnerabilities, and integrates well with Home Assistant. Be aware of the GPL-3.0-or-later copyleft license, the Python 3.14.0 requirement, and the Windows MQTT limitation. The reverse-engineered API carries inherent risk of breaking changes if Ecovacs alters their protocol.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.14.0 or later.
- On Windows, aiomqtt has a known limitation; see project documentation for workaround.
- Requires an active Ecovacs account set up via smartphone app.
License · maintenance · safety
GPL-3.0-or-later (copyleft) — Licensed under GPL-3.0-or-later (copyleft). Any derivative work or application bundling this library must also be released under a compatible open-source license.
last release 2026-07-30 (15 days) · last repo commit 2026-08-14 · 115 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 90,982 downloads/mo, #13,552 on PyPI
Alternatives
Verify before relying
pip install deebot-client
import asyncio
from deebot_client.api_client import ApiClient
from deebot_client.authentication import Authenticator, create_rest_config
from deebot_client.device import Device
from deebot_client.mqtt_client import MqttClient, create_mqtt_config
import aiohttp
async with aiohttp.ClientSession() as session:
rest_config = create_rest_config(session, device_id="id", alpha_2_country="DE")
authenticator = Authenticator(rest_config, "account_id", "password_hash")
api_client = ApiClient(authenticator)
devices = await api_client.get_devices()- Whether all Deebot device models are supported or only a subset
- Real-world latency and reliability of command execution over MQTT
- Whether the reverse-engineered API is stable or subject to breaking changes from Ecovacs
What it is and what it does
deebot-client is a reverse-engineered Python library that communicates with Ecovacs Deebot robotic vacuums through the manufacturer's cloud REST API and MQTT messaging protocol. It allows developers to authenticate with an Ecovacs account, retrieve paired devices, send cleaning commands, and subscribe to device events like battery status changes. The library is maintained as a community contribution project and is not officially supported by Ecovacs.
The package wraps async I/O operations using aiohttp and aiomqtt, with cryptographic utilities for authentication. It exposes a Device class for command execution and an event subscription system. Because the API is reverse-engineered, the maintainers note that feature coverage depends on community contributions and cannot be guaranteed to remain stable.
Use it for
- Integrate Deebot vacuums into Home Assistant or other home automation platforms via a Python client
- Build custom scheduling or geofencing logic to trigger vacuum commands based on external events
- Monitor battery level, cleaning status, and other device telemetry in real time via event subscriptions
- Create a web dashboard or mobile app backend that controls multiple Deebot devices remotely
- Automate vacuum operation as part of a broader smart-home workflow (e.g., start cleaning when leaving home)
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own a Deebot vacuum and want programmatic control for home automation.
The library is actively maintained, has no known vulnerabilities, and integrates well with Home Assistant. Be aware of the GPL-3.0-or-later copyleft license, the Python 3.14.0 requirement, and the Windows MQTT limitation. The reverse-engineered API carries inherent risk of breaking changes if Ecovacs alters their protocol.
Install
deebot-client on PyPI
Before you install
Medium install friction due to 6 runtime dependencies including aiohttp, aiomqtt, and cryptography. Actively maintained with a recent release (15 days old) and steady repository activity. Note: aiomqtt has a known Windows limitation documented in the project.
Requires Python 3.14.0 or later. On Windows, aiomqtt has a known limitation; see project documentation for workaround. Requires an active Ecovacs account set up via smartphone app.
License in practice
Licensed under GPL-3.0-or-later (copyleft). Any derivative work or application bundling this library must also be released under a compatible open-source license.
Quickstart
pip install deebot-client
import asyncio
from deebot_client.api_client import ApiClient
from deebot_client.authentication import Authenticator, create_rest_config
from deebot_client.device import Device
from deebot_client.mqtt_client import MqttClient, create_mqtt_config
import aiohttp
async with aiohttp.ClientSession() as session:
rest_config = create_rest_config(session, device_id="id", alpha_2_country="DE")
authenticator = Authenticator(rest_config, "account_id", "password_hash")
api_client = ApiClient(authenticator)
devices = await api_client.get_devices()Verify before relying
- Whether all Deebot device models are supported or only a subset
- Real-world latency and reliability of command execution over MQTT
- Whether the reverse-engineered API is stable or subject to breaking changes from Ecovacs
Package facts
| License | GPL-3.0-or-later copyleft |
| Python support | Capped below the current Python release >=3.14.0 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 6 packagesaiohttpaiomqttcachetoolscryptographydefusedxmlorjson |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 90,982 / month, #13,552 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersProgramming Language :: Python :: 3.14Topic :: Home AutomationTopic :: Software Development :: Libraries :: Python Modules |
Evidence: deebot_client-18.5.1-cp314-cp314-macosx_10_12_x86_64.whl; deebot_client-18.5.1-cp314-cp314-macosx_11_0_arm64.whl; deebot_client-18.5.1-cp314-cp314-manylinux_2_34_aarch64.whl; deebot_client-18.5.1-cp314-cp314-manylinux_2_34_x86_64.whl; deebot_client-18.5.1-cp314-cp314-musllinux_1_2_aarch64.whl; deebot_client-18.5.1-cp314-cp314-musllinux_1_2_x86_64.whl; deebot_client-18.5.1-cp314-cp314-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “deebot vacuum control library”
- deebot-clientA Python client library for controlling Ecovacs Deebot robotic…
- python-roborockControl Roborock vacuum cleaners online and offline through a Python…
- pybotvacpybotvac provides an unofficial Python API to control Neato Botvac…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also pybotvac · python-roborock · vacuum-map-parser-base · wandelbots_api_client · pymammotion · switchbot-api · meross-iot · tuya-device-sharing-sdk · yoto-api · vacuum-map-parser-roborock