Skip to content
Melbourne University RacingMelbourne University RacingMUR Autonomous WikiAutonomous Wiki

Quick Start

On this page

Run mura in simulation, on the bench, or on the car.

There are three ways to run mura, and each one puts more real hardware in place of the simulator:

Start with SIL. You don’t need any hardware for it.

  1. Install Pixi. mura builds on Linux and Apple Silicon Macs.

  2. Clone and build mura:

    Terminal window
    git clone https://github.com/Melbourne-University-Motorsports/mura.git
    cd mura
    pixi install
    pixi run build
  3. Start the simulator with the stack driving it:

    Terminal window
    pixi run ros2 launch mura_bringup sim.launch.py
  4. Open Foxglove, choose Open connection → Foxglove WebSocket, and connect to ws://localhost:8765. In the 3D panel, set the display frame to map.

You should see the car driving a circle.

To see the car model instead of a bare frame, run this in a second terminal, then add a URDF layer from /robot_description in the 3D panel:

Terminal window
pixi run ros2 launch mura_sim publish_urdf.launch.py

Start the simulator on its own, without the stack:

Terminal window
pixi run ros2 launch mura_sim mura_sim.launch.py

Then drive with the keyboard in a second terminal, or with Foxglove’s Teleop panel publishing to /cmd_vel:

Terminal window
pixi run ros2 run teleop_twist_keyboard teleop_twist_keyboard

i accelerates, , brakes, j and l steer, and k zeroes the input. The simulator takes acceleration, not speed, so the car keeps rolling when you let go.

  • mura README: building, adding packages and common build problems.
  • mura_sim README: launch arguments, topics, parameters and how the simulator works.
  • mura_core README: the nodes in the stack and the topics between them.