![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro humble. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro jazzy. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro kilted. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro rolling. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 yolo_bringup yolo_msgs yolo_ros |
Repository Summary
Description | Ultralytics YOLOv8, YOLOv9, YOLOv10, YOLOv11, YOLOv12 for ROS 2 |
Checkout URI | https://github.com/mgonzs13/yolo_ros.git |
VCS Type | git |
VCS Version | main |
Last Updated | 2025-07-25 |
Dev Status | UNKNOWN |
Released | UNRELEASED |
Tags | object-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
Name | Version |
---|---|
yolo_bringup | 4.2.0 |
yolo_msgs | 4.2.0 |
yolo_ros | 4.2.0 |
README
yolo_ros
ROS 2 wrap for YOLO models from Ultralytics to perform object detection and tracking, instance segmentation, human pose estimation and Oriented Bounding Box (OBB). There are also 3D versions of object detection, including instance segmentation, and human pose estimation based on depth images.
[](https://opensource.org/license/gpl-3-0) [](https://github.com/mgonzs13/yolo_ros/releases) [](https://github.com/mgonzs13/yolo_ros?branch=main) [](https://libraries.io/github/mgonzs13/yolo_ros?branch=main) [](https://github.com/mgonzs13/yolo_ros/commits/main) [](https://github.com/mgonzs13/yolo_ros/issues) [](https://github.com/mgonzs13/yolo_ros/pulls) [](https://github.com/mgonzs13/yolo_ros/graphs/contributors) [](https://github.com/mgonzs13/yolo_ros/actions/workflows/python-formatter.yml?branch=main)
| ROS 2 Distro | Branch | Build status | Docker Image | Documentation |
| :----------: | :------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Foxy** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/foxy-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=foxy) | [](https://mgonzs13.github.io/yolo_ros/latest) |
| **Galactic** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/galactic-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=galactic) | [](https://mgonzs13.github.io/yolo_ros/latest) |
| **Humble** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/humble-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=humble) | [](https://mgonzs13.github.io/yolo_ros/latest) |
| **Iron** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/iron-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=iron) | [](https://mgonzs13.github.io/yolo_ros/latest) |
| **Jazzy** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/jazzy-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=jazzy) | [](https://mgonzs13.github.io/yolo_ros/latest) |
| **Kilted** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/kilted-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=kilted) | [](https://mgonzs13.github.io/yolo_ros/latest) |
| **Rolling** | [`main`](https://github.com/mgonzs13/yolo_ros/tree/main) | [](https://github.com/mgonzs13/yolo_ros/actions/workflows/rolling-docker-build.yml?branch=main) | [](https://hub.docker.com/r/mgons/yolo_ros/tags?name=rolling) | [](https://mgonzs13.github.io/yolo_ros/latest) |
Table of Contents
Installation
cd ~/ros2_ws/src
git clone https://github.com/mgonzs13/yolo_ros.git
pip3 install -r yolo_ros/requirements.txt
cd ~/ros2_ws
rosdep install --from-paths src --ignore-src -r -y
colcon build
Docker
Build the yolo_ros docker.
docker build -t yolo_ros .
Run the docker container. If you want to use CUDA, you have to install the NVIDIA Container Tollkit and add --gpus all
.
docker run -it --rm --gpus all yolo_ros
Models
The compatible models for yolo_ros are the following:
Usage
Click to expand
### YOLOv5 ```bash ros2 launch yolo_bringup yolov5.launch.py ``` ### YOLOv8 ```bash ros2 launch yolo_bringup yolov8.launch.py ``` ### YOLOv9 ```bash ros2 launch yolo_bringup yolov9.launch.py ``` ### YOLOv10 ```bash ros2 launch yolo_bringup yolov10.launch.py ``` ### YOLOv11 File truncated at 100 lines [see the full file](https://github.com/mgonzs13/yolo_ros/tree/main/README.md)CONTRIBUTING
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro galactic. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro iron. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro melodic. Known supported distros are highlighted in the buttons above.
![]() |
yolo_ros repositoryobject-detection human-pose-estimation object-tracking obb ros2 instance-segmentation oriented-bounding-box 3d-object-detection ultralytics yolov8 3d-human-pose-estimation yolov9 yolov10 yolov11 yolov12 |
No version for distro noetic. Known supported distros are highlighted in the buttons above.