oomwoo logo

oomwoo

Open-source vacuum robot cleaner

status early development
GitHub

What is it?

What it is

OOMWOO is an open-source robot vacuum you can build yourself, targeting Raspberry Pi, ROS2, Home Assistant, and 3D‑printing communities, using an affordable 2D LiDAR for mapping and autonomous navigation.

Why it exists

To provide an affordable, fully open hardware/software/firmware robot vacuum that avoids vendor lock‑in, enables local operation without cloud, and is easy to build with step‑by‑step instructions while delivering product‑quality performance.

Who should use it

Open‑source robotics hobbyists, makers, and developers who want to build and customize a robot vacuum from scratch, especially those familiar with ROS2, Raspberry Pi, and 3D printing.

Who should avoid it

Users looking for a plug‑and‑play commercial vacuum or beginners without any robotics or electronics experience, as the project is in early development and requires significant DIY effort.

How it works

A quick walkthrough in plain English

How oomwoo works

Step 1 of 3

You interact with it

Open oomwoo, send a request, or connect it to your stack.

Features

Open-source robot vacuum design
Raspberry Pi and ESP32 based hardware
ROS2 and Nav2 integration for autonomous navigation
2D LiDAR mapping and SLAM
Home Assistant native integration
3D‑printed, hackable chassis
Modular firmware and software architecture
Simulation support via Gazebo
Local, cloud‑free operation
Step‑by‑step build and bring‑up instructions
Community‑driven contribution model

Advantages

  • Open source (Apache-2.0)
  • Active Python ecosystem
  • Self-hosted deployment options

Disadvantages

  • Requires operational ownership for self-hosted setups
  • Community support varies by project maturity

Installation

FAQ

What is OOMWOO and what makes it different from commercial robot vacuums?

OOMWOO is an open‑source home robot vacuum that you can build yourself. It is designed for Raspberry Pi, ROS2, Home Assistant, and 3D‑printing communities. Unlike commercial models, OOMWOO is fully open hardware, software, and firmware, uses an affordable 2D LiDAR for mapping and autonomous navigation, and offers local, cloud‑free operation with optional cloud features. The project emphasizes hackability, high build quality, and community‑driven development.

What hardware do I need to build an OOMWOO robot?

The core hardware includes a Raspberry Pi (Pi 5 or Pi 4), a 2D LiDAR sensor, motor drivers, an I/O PCB with an STM32G070 MCU, and 3D‑printed chassis parts. A motor, brush, and suction system are also required. A full Bill of Materials (BoM) is in progress, and a kit with all parts will be available from makerspet.com once the hardware design is finalized.

How do I get started with the software side of OOMWOO?

First install the ROS2 development environment from the oomwoo‑install repository. Then clone the OOMWOO ROS2 URDF package and run the Gazebo simulation to test the robot model. For real‑world testing you can connect a placeholder vacuum (e.g., Proscenic M6 Pro) using the provided ROS2 bridge. Detailed tutorials and step‑by‑step instructions are available on makerspet.com/learn.

Can I contribute to OOMWOO and how?

Yes! Contributions are organized by modules. Pick a module from the "Requests for Contributions" table, let the community know in Discussions, and open a PR under the path contributions/module‑name/your‑github‑username. Follow the CONTRIBUTING guide and the ARCHITECTURE.md for design details. The project welcomes developers of all skill levels.

What kind of ROS2 navigation does OOMWOO support?

OOMWOO uses ROS2 Nav2 for autonomous navigation. It supports SLAM mapping, AMCL localization, recovery behaviors, docking cycles, and can operate on a known map. The simulation and placeholder hardware are set up to test these features, and the code is structured to allow adding new navigation behaviors or safety features.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for oomwoo

sd

80,246 views

Starts at 00:00

Share

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
oomwoo | MushyBook