vacuum-map-parser-base
Common code for vacuum map parsers
Decision gist · record as of 2026-08-14
Yes, if you are building a vacuum-specific map parser or integrating with a robot vacuum API. Install only as a dependency of a brand-specific implementation (roborock, viomi, roidmi, or dreame), not directly for end-user functionality. The active maintenance, low friction, and permissive license make it a sound foundation for this use case.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; designed as a base class requiring extension by vacuum-specific implementations.
- Low install friction with a single dependency on Pillow.
- Actively maintained with recent commits and regular releases since initial 2023 release.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions.
last release 2025-05-05 (466 days) · last repo commit 2026-02-18 · 3 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 82,977 downloads/mo, #14,112 on PyPI
Alternatives
Verify before relying
pip install vacuum-map-parser-base
from vacuum_map_parser_base import MapParser
# Extend MapParser in your vacuum-specific implementation- What specific map formats or vacuum models the base parser is designed to support.
- Whether the base classes provide image processing utilities or only data structure definitions.
- How the extension pattern works and what methods subclasses must implement.
What it is and what it does
Vacuum Map Parser Base is a foundational library that defines the common interface and base classes for parsing map data from robot vacuum cleaners. It is not meant to be used directly but rather extended by vacuum-brand-specific implementations (such as those for Roborock, Viomi, Roidmi, or Dreame models). The package provides the structural framework that these implementations build upon, handling shared concerns around map parsing and image processing through its single runtime dependency, Pillow.
The package targets developers building integrations with robot vacuum APIs or home automation systems that need to work with vacuum-generated maps. It is actively maintained, supports current Python versions (3.11+), and carries no known security vulnerabilities. Its small dependency footprint and permissive Apache-2.0 license make it suitable for both open-source and commercial projects.
Use it for
- Building a home automation integration that needs to parse and display robot vacuum floor maps.
- Creating a vacuum-specific map parser by extending the base classes for a particular robot model.
- Developing a unified dashboard that aggregates maps from multiple vacuum brands using their respective parsers.
- Processing and analyzing vacuum-generated map data for research or debugging purposes.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a vacuum-specific map parser or integrating with a robot vacuum API.
Install only as a dependency of a brand-specific implementation (roborock, viomi, roidmi, or dreame), not directly for end-user functionality. The active maintenance, low friction, and permissive license make it a sound foundation for this use case.
Install
vacuum-map-parser-base on PyPI
Before you install
Low install friction with a single dependency on Pillow. Actively maintained with recent commits and regular releases since initial 2023 release.
Requires Python 3.11 or later; designed as a base class requiring extension by vacuum-specific implementations.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions.
Quickstart
pip install vacuum-map-parser-base
from vacuum_map_parser_base import MapParser
# Extend MapParser in your vacuum-specific implementationVerify before relying
- What specific map formats or vacuum models the base parser is designed to support.
- Whether the base classes provide image processing utilities or only data structure definitions.
- How the extension pattern works and what methods subclasses must implement.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4.0,>=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagePillow |
| Maintenance | Actively maintained 466 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 82,977 / month, #14,112 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Topic :: Home Automation |
Evidence: vacuum_map_parser_base-0.1.5-py3-none-any.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 › “vacuum map parser base classes”
- vacuum-map-parser-baseProvides base classes and utilities for parsing vacuum cleaner map…
- vacuum-map-parser-roborockParses map data generated by Roborock vacuum cleaners, converting raw…
- 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 Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also vacuum-map-parser-roborock · python-roborock · pybotvac · deebot-client · robotframework-extendedselenium2library · robotframework-robocop · pylitterbot · basemap-data · iso18245 · basemap