explaingit

makerspet/oomwoo

Analysis updated 2026-07-03 · repo last pushed 2026-07-03

⭐ Rising3,269PythonAudience · generalComplexity · 4/5ActiveSetup · hard

TLDR

An open-source, 3D-printable robot vacuum cleaner that maps and navigates your home autonomously using a Raspberry Pi and 2D LiDAR, with no cloud connection required and native Home Assistant integration.

Mindmap

mindmap
  root((repo))
    What it does
      Maps your home locally
      Navigates autonomously
      No cloud required
    Tech stack
      Raspberry Pi
      ROS2
      2D LiDAR sensor
    Use cases
      Local smart home vacuum
      DIY home appliance
      Home Assistant automation
    Audience
      Makers and hobbyists
      Smart home enthusiasts
    Hardware
      3D-printed chassis
      Tapered rubber rollers
      Optional parts kit
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build your own robot vacuum that cleans and navigates your home autonomously.

USE CASE 2

Add a locally-controlled vacuum to your Home Assistant smart home setup without cloud dependency.

USE CASE 3

3D-print and assemble a custom robot vacuum using affordable, sourceable parts.

What is it built with?

PythonROS2Raspberry Pi2D LiDAR3D Printing

How does it compare?

makerspet/oomwoomuxuuu/serenity-skillmisolabsai/misotts
Stars3,2693,2043,061
LanguagePythonPythonPython
Last pushed2026-07-032026-05-052026-06-09
MaintenanceActiveMaintainedActive
Setup difficultyhardeasyhard
Complexity4/52/54/5
Audiencegeneralpm founderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires sourcing parts, 3D-printing a chassis, and assembling hardware with a Raspberry Pi and LiDAR sensor before any software can run.

The explanation does not specify the license type for this project.

In plain English

oomwoo is an open-source robot vacuum cleaner you build yourself, designed to be a real home appliance rather than a weekend toy. The goal is to let you source parts, 3D-print the chassis, and assemble a vacuum that maps your home and navigates autonomously using an affordable 2D laser sensor. Crucially, it works entirely locally without any cloud connection required, meaning no forced vendor lock-in or remote server dependencies. The system runs on a Raspberry Pi and uses a robotics framework called ROS2 to handle navigation and mapping. A 2D laser scanner (LiDAR) spins around to map your home's layout so the robot can figure out where it is and where it needs to go. The physical body is entirely 3D-printable, and the software is designed to integrate natively with Home Assistant, a popular local smart home platform. This means you can control and automate the vacuum right from your own home network without relying on a third-party app. This project is aimed at makers, hobbyists, and smart home enthusiasts who want full control over their devices. A concrete use case is someone who already uses Home Assistant to manage their smart lights and wants a vacuum that fits seamlessly into that local setup. If you enjoy 3D printing and building your own electronics, this gives you a path to a high-quality appliance without buying a proprietary brand off the shelf. The creator also plans to sell a convenience kit for people who want to skip the parts hunt, though sourcing everything yourself remains entirely possible. It is important to note that the project is still in the early development phase. The team is currently validating parts and writing step-by-step build instructions, with a target to finalize the first parts list around mid-July. The core cleaning behaviors, like navigation and docking, are being developed as separate community modules that volunteers can build and test in simulation. The design research is thorough, drawing on teardowns of commercial vacuums to decide which features to copy, like tapered rubber rollers to prevent hair tangles, and which to skip, like self-washing mop rollers.

Copy-paste prompts

Prompt 1
Using the oomwoo open-source robot vacuum project, help me set up the Raspberry Pi with ROS2 and configure the 2D LiDAR sensor for home mapping.
Prompt 2
I have Home Assistant running locally. How do I integrate the oomwoo robot vacuum so I can control and automate it from my smart home dashboard?
Prompt 3
I want to 3D-print and assemble the oomwoo vacuum. Help me create a parts sourcing checklist based on the project's recommended components and bill of materials.
Prompt 4
Help me understand how to set up and test the oomwoo vacuum's navigation and docking behaviors in simulation before assembling the physical robot.

Frequently asked questions

What is oomwoo?

An open-source, 3D-printable robot vacuum cleaner that maps and navigates your home autonomously using a Raspberry Pi and 2D LiDAR, with no cloud connection required and native Home Assistant integration.

What language is oomwoo written in?

Mainly Python. The stack also includes Python, ROS2, Raspberry Pi.

Is oomwoo actively maintained?

Active — commit in last 30 days (last push 2026-07-03).

What license does oomwoo use?

The explanation does not specify the license type for this project.

How hard is oomwoo to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is oomwoo for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub makerspet on gitmyhub

Verify against the repo before relying on details.