Shunkobot is an omnidirectional autonomous robot developed as an academic project by students enrolled in the Master's degree program in Automation Engineering at the Polytechnic University of Bari, as part of the Mobile Robotics course.
The main objective of the project is to create a modular, scalable, and fully replicable robotic platform that can serve as a teaching and research reference in the field of autonomous mobile robotics. Shunkobot is therefore a testing ground for the development and validation of advanced perception, planning, and control algorithms, as well as a tool to support teaching and applied research.
The robot has two operating modes:
- Teleoperated, which allows the use of the robotic arm and does not require the Raspberry Pi;
- Autonomous + Teleoperated with ROS2, in which the arm has not been checked but the software basis for implementing it is in place.
The repository is structured to keep the main clone lightweight, using submodules to separate major components.
| Robot Overview | General Software Logic Design |
|---|---|
 |
 |
By default, cloning the repository downloads only the core code (STM32 and utilities). Additional modules (such as 3D models or ROS2 code) are included as submodules, which you can clone as needed.
Note: Cloning with GitHub Desktop will download all files, including submodules, by default.
| Module | Description | Link |
|---|---|---|
ShunkoBot_STM32Code/ |
Firmware for STM32 microcontroller | README |
ShunkoBot_Shield/ |
ShunkoBot Custom Shield for STM32 | README |
ShunkoBot_3Dmodel/ |
3D model of the robot | README |
ShunkoBot_ROS2/ |
ROS2 code used on the Raspberry Pi and PC | README |
ShunkoBot_GazeboSim/ |
ROS2 Simulation Software on your PC | README |
diy-radio-controller/ |
3D model and firmware for RF Arduino Joypad | README |
To clone the repository and all submodules:
git clone --recurse-submodules https://github.com/murcie443/Shunko_BotIf you already cloned the repository without submodules, run:
git submodule update --init --recursive
If you are interested in learning more, you can find detailed explanations in the READMEs of each module and in the full project report!
All components of this project are released under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0) license, except for the ROS2 software.
Under the CC BY-NC-SA 4.0 license, you can share and adapt the material, as long as you:
- Give appropriate credit
- Do not use it for commercial purposes
- Distribute any changes under the same license
- Don’t add legal or technical restrictions
The ROS2 software is distributed under a dual-license model:
- Open Source License: GNU Affero General Public License v3.0 (AGPLv3)
- Commercial License: Available upon request for proprietary use.
For specific terms and details, please refer to the LICENSE files located in each respective folder.
ShunkoBot © 2025 by Francesco Stasi, Davide Tonti, Simona Vatinno is licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International.
For commercial licensing inquiries or any questions regarding the use of this project, please contact us at:
[email protected]