User Guide#

MICROROBOTICA is the integrated development environment for the Microrobotics Simulation Framework. It loads MIME experiments from disk, drives the JAX runner as a managed subprocess over ZMQ, streams results into a USD-backed viewport, and produces the IEC-62304-aligned audit trail required for clinical-grade adoption.

Getting started#

The fastest path to a running experiment:

  1. Install MICROROBOTICA from source — the supported path is the GHCR Docker image (docker pull ghcr.io/microrobotics-simulation-framework/microrobotica:base) plus CMake.

  2. Install MADDENING + MIME from PyPI (pip install mime-engine) so the IDE can spawn the runner.

  3. Launch microrobotica and open one of the bundled experiments via File → Open Experiment — the IDE spawns the MIME runner in the background and waits for its ZMQ endpoint to come up.

  4. Hit Simulation → Start. Slide parameter values live; the IDE forwards them to the runner without rebuilding the graph.

  5. Use the timeline to scrub through the resulting USDC recording.

What’s in this section#

  • Installation — Docker (recommended) + native build paths.

  • Using the libraries — installing MADDENING and MIME, and writing your own MIME experiment.

  • Concepts — the three-layer USD composition stack, compute backends, and the embedded scripting console.