MCPcopy Index your code
hub / github.com/WinstonJQ/YOLOv5-ROS

github.com/WinstonJQ/YOLOv5-ROS @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
673 symbols 2,636 edges 50 files 65 documented · 10%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

YOLOv5-ROS

Overview

This project connects YOLOv5 with ROS (Robot Operating System), enabling real-time object detection directly from robot sensor topics.
The system subscribes to image topics published by the robot, processes the images through YOLOv5, and performs efficient object detection.

It is designed to serve as a flexible, plug-and-play perception module for various robotic platforms requiring visual detection or perception capabilities.


Key Features

  • ROS Integration: Seamless connection between YOLOv5 and ROS.
  • Topic Subscription: Automatically subscribes to ROS image topics for detection input.
  • Visualization: Displays YOLOv5 detection results in a pop-up window with bounding boxes.
  • Data Interface: Provides access to bounding box data for each detected object for downstream processing.
  • Code Documentation: Includes clear modification notes and comments to help users adapt the code for their own robot platforms.

This makes the project suitable for a wide range of robotic applications, including autonomous navigation, warehouse robots, and mobile manipulation tasks.


Project Overview

  • Input: Any ROS image topic published by a robot’s camera or sensor (e.g., /camera/image_raw).
  • Output:
  • A visualization window showing YOLOv5 detection bounding boxes.
  • Access to bounding box data for further algorithmic processing.

Usage Guide

🚧 Currently being updated...
Detailed setup instructions, including installation, topic configuration, and example launch files, will be added soon.


Reference Project

This implementation is inspired by and extends the following open-source project:
yolov5_ros


License

This project follows the same open-source license as YOLOv5 and the referenced yolov5_ros repository.
Please review the respective repositories for specific license information.

Core symbols most depended-on inside this repo

info
called by 163
src/yolov5/models/yolo.py
colorstr
called by 45
src/yolov5/utils/general.py
run
called by 34
src/yolov5/utils/callbacks.py
check_requirements
called by 25
src/yolov5/utils/general.py
time
called by 22
src/yolov5/utils/general.py
save
called by 22
src/yolov5/models/common.py
select_device
called by 20
src/yolov5/utils/torch_utils.py
tolist
called by 19
src/yolov5/models/common.py

Shape

Method 333
Function 242
Class 97
Route 1

Languages

Python100%

Modules by API surface

src/yolov5/models/common.py86 symbols
src/yolov5/utils/general.py77 symbols
src/yolov5/models/tf.py65 symbols
src/yolov5/utils/dataloaders.py53 symbols
src/yolov5/utils/loggers/comet/__init__.py31 symbols
src/yolov5/utils/torch_utils.py30 symbols
src/yolov5/utils/plots.py27 symbols
src/yolov5/utils/loggers/__init__.py25 symbols
src/yolov5/utils/augmentations.py25 symbols
src/yolov5/models/yolo.py23 symbols
src/yolov5/utils/loggers/wandb/wandb_utils.py22 symbols
src/yolov5/utils/activations.py20 symbols

For agents

$ claude mcp add YOLOv5-ROS \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact