supermimic README

The project's README from github.com/HybridRobotics/supermimic. As one markdown file: README.md.

SuperMimic

Project page | Paper

SuperMimic trains a humanoid whole-body motion tracker with one differentiable world model, built on mjlab.

Setup

Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Clone both repos as siblings:

mkdir supermimic_ws && cd supermimic_ws
git clone [email protected]:HybridRobotics/supermimic.git
git clone [email protected]:HybridRobotics/mjlab_research.git
cd supermimic

Usage

Available task IDs:

Train a world model and policy:

CUDA_VISIBLE_DEVICES=<GPU_ID> uv run src/supermimic/scripts/train.py \
  <TASK_ID> --runner.run_name <description>

Play back a trained model:

uv run src/supermimic/scripts/play.py \
  <TASK_ID> --wandb-path <RUN_PATH>

Acknowledgements

SuperMimic contains code inspired by these projects:

License

Copyright 2026 The SuperMimic Authors.

Released under the Apache License 2.0.

supermimic (HybridRobotics/supermimic)

Searching Database…

What is this?SuperMimic is a research codebase that trains a humanoid robot to track whole-body motion. It uses one differentiable world model and is built on mjlab.
Is it a library I can import, or something I run?You run it. It is a training and playback tool with commands to train a world model and policy and to play back a trained one, not a package to import into your code.
How do I get it running?Install uv, clone SuperMimic and mjlab as sibling directories, then use the train and play commands from the README.
What do I need before I start?uv for environment setup and a local checkout of mjlab next to SuperMimic. The README does not list GPU, Python version or OS requirements.
What makes the 'one differentiable world model' approach special?The README says one differentiable world model trains the whole-body tracker, but it does not explain the method in detail. The paper linked from the README is the place to learn how it works.
How do the two task IDs differ in practice?Both target the G1 humanoid. GenCoord describes the robot with generalized coordinates, while MaxCoord uses maximal coordinates, so the choice depends on which representation you want to compare.
Can I see a trained model before training my own?The README includes a step to play back a trained model, so you can check the results. Where to get a trained checkpoint is not stated in the README text.
Size
0.8 MB
Stars
1.7K
Updated
CommitNov 16
Age
8d
Commits · 90 Days