Menagerie is a collection of high-quality models for the MuJoCo physics engine, curated by Google DeepMind.

A physics simulator is only as good as the model it is simulating, and in a powerful simulator like MuJoCo with many modeling options, it is easy to create "bad" models which do not behave as expected. The goal of this collection is to provide the community with a curated library of well-designed models that work well right out of the gate.

• Getting Started
  • Prerequisites
  • Overview
  • Usage
• Python Package
• Model Quality and Contributing
  • Quick contributor setup
• Menagerie Models
• Citing Menagerie
• Acknowledgments
• Changelog
• License and Disclaimer

The minimum required MuJoCo version for each model is specified in its respective README. You can download prebuilt binaries for MuJoCo from the GitHub releases page, or if you are working with Python, you can install the native bindings from PyPI via pip install mujoco. For alternative installation instructions, see here.

The structure of Menagerie is illustrated below. For brevity, we have only included one model directory since all others follow the exact same pattern.

├── unitree_go2
│   ├── assets
│   │   ├── base_0.obj
│   │   ├── ...
│   ├── go2.png
│   ├── go2.xml
│   ├── LICENSE
│   ├── README.md
│   └── scene.xml
│   └── go2_mjx.xml
│   └── scene_mjx.xml

• assets: stores the 3D meshes (.stl or .obj) of the model used for visual and collision purposes
• LICENSE: describes the copyright and licensing terms of the model
• README.md: contains detailed steps describing how the model's MJCF XML file was generated
• <model>.xml: contains the MJCF definition of the model
• scene.xml: includes <model>.xml with a plane, a light source and potentially other objects
• <model>.png: a PNG image of scene.xml
• <model>_mjx.xml: contains an MJX-compatible version of the model. Not all models have an MJX variant.
• scene_mjx.xml: same as scene.xml but loads the MJX variant