whatisgithub

What is oomwoo-one?

makerspet/oomwoo-one — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

A ROS 2 robot description and Gazebo simulation package for OOMWOO One, an open-source robot vacuum you can build yourself.

Mindmap

mindmap
  root((OOMWOO One))
    What it does
      Robot vacuum description
      Gazebo simulation
      SLAM and navigation
    Tech stack
      ROS 2
      Gazebo
      URDF
    Use cases
      Simulate before building
      Teleop and mapping
      DIY vacuum robot base
    Audience
      Robotics hobbyists
      Developers

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

Simulate a DIY robot vacuum in Gazebo with mapping and navigation before building real hardware.

USE CASE 2

Drive a simulated or physical OOMWOO One vacuum around with keyboard teleop while it builds a map.

USE CASE 3

Use it as a starting robot description for building your own ROS 2 based vacuum robot.

What is it built with?

ROS 2PythonGazeboURDFNav2

How does it compare?

makerspet/oomwoo-one1038lab/comfyui-agnes-aiadityaarsharma/wordpress-malware-removal
Stars181818
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity4/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires ROS 2 Jazzy and Gazebo installed, connecting a physical robot needs SangamIO set up on the vacuum first.

Apache 2.0 lets you use, modify, and distribute the code, including commercially, as long as you keep attribution and license notices.

So what is it?

OOMWOO One is the software description for a real, physical robot vacuum cleaner you can build yourself, part of a broader open source project called OOMWOO. This repository specifically contains the robot's description for ROS 2, the standard software framework used in robotics, along with everything needed to simulate the vacuum inside Gazebo, a 3D physics simulator, before you ever touch real hardware. Inside, you will find a detailed 3D model of the vacuum's physical shape, roughly 349 millimeters across, including its body, its spinning LiDAR sensor turret used for mapping a room, two independently driven wheels, and a caster wheel. There is also configuration for combining odometry and inertial sensor data to estimate the robot's position, tuning files for SLAM, the technique robots use to build a map of a room while tracking their own location within it, and for Nav2, the navigation system that lets the robot plan and follow paths. A separate set of files wires the simulated version of the robot up in Gazebo, including a simulated LiDAR and bumper sensors on the front of the robot, with a linked document explaining some quirks in how the simulated bumpers behave. You can try the whole thing without owning a physical robot: after selecting this robot model in the shared launch configuration, a few ROS 2 launch commands start the simulated world, bring up navigation and mapping, and let you drive the simulated vacuum around with your keyboard. If you do have a real robot, similar commands connect to it over your local network instead, using a companion piece of software called SangamIO that needs to be set up on the vacuum first, and you can then save the map it builds for future use. The README is honest that the robot's physical measurements in this file are approximations meant to be refined against your own actual robot. The project is released under the Apache 2.0 license and has attracted eighteen stars on GitHub, reflecting a small but active hobbyist robotics community around DIY robot vacuums.

Copy-paste prompts

Prompt 1
Help me launch the oomwoo-one simulation in Gazebo with SLAM enabled.
Prompt 2
Explain how the EKF config fuses odometry and IMU data to localize this robot.
Prompt 3
Show me how to connect this ROS 2 package to a physical robot vacuum on my network.

Frequently asked questions

What is oomwoo-one?

A ROS 2 robot description and Gazebo simulation package for OOMWOO One, an open-source robot vacuum you can build yourself.

What language is oomwoo-one written in?

Mainly Python. The stack also includes ROS 2, Python, Gazebo.

What license does oomwoo-one use?

Apache 2.0 lets you use, modify, and distribute the code, including commercially, as long as you keep attribution and license notices.

How hard is oomwoo-one to set up?

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

Who is oomwoo-one for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.