MuSHR

MuSHR is a low-cost 1/10-scale RC car platform for multi-agent non-holonomic racing and autonomous navigation research.

This repository contains executable files that Robotheca doesn't check. Only run them if you trust the creator.

Which files (6 scripts)

What it can do

Written by Robotheca from the project's documents.

Can be driven by a teleop mode that starts automatically at boot when the front bumper button is held.
Teleop can be stopped remotely over SSH by killing the roslaunch process.
Built on ROS, with components for simulation, localization, navigation and planning.

This repository has no parts list Robotheca can read yet.

The guide appears here as you scroll.

Guide by @prl-mushr (README.md), under BSD-3-Clause.

Notes written by Robotheca from the project's documents.

Incomplete documentation

How complete the published files are for rebuilding this robot, measured by Robotheca at commit 2030b90. It isn't a rating of the robot.

3D and CAD files10/20
24 printable parts (STL, 3MF).
Add the CAD source (STEP, or the CAD program's own files) so people can change the design.
Robot description0/15
No URDF.
Add a URDF: the robot can then be seen in 3D and tried in the browser.
Parts list0/20
No parts list in the repository or linked.
Most points to gain: Link to your parts list, or add it to the repository (a CSV or a Markdown table) with quantities, prices and where to buy each part.
Software15/15
Code in this repository, instructions to install or run it, built on ros.
Documentation10/15
README of 2,594 characters with 1 picture; 0 build steps.
Split the build into at least 3 steps.
Simulation0/5
No simulation files.
Add a simulation model (MuJoCo, Gazebo, Webots or Isaac).
Licenses10/10
Hardware: BSD-3-Clause; software: BSD-3-Clause.

Written by Robotheca from the project's documents.

Copy teleop-on-startup.sh to the car, preferably at /home/robot/teleop-on-startup.sh.
Edit /etc/rc.local and add the line that runs teleop-on-startup.sh as the robot user at boot.
Set the ROS_DISTRO and WORKSPACE variables so the script sources the correct ROS setup and catkin workspace (default ~/catkin_ws).
To stop teleop, ssh into the car and run pkill roslaunch.

Robotheca doesn't review code. Read it before running it.

Every file of the project: code, CAD, electronics, guides, at commit 2030b90.

Questions and improvements go to the creator's repository.