whatisgithub

What is pmt?

mondo-robotics/pmt — explained in plain English

Analysis updated 2026-05-18

211PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

A research codebase for training a humanoid robot to imitate human motions like flips and dances using reinforcement learning in Isaac Lab.

Mindmap

mindmap
  root((repo))
    What it does
      Trains humanoid motion tracking
      Uses reinforcement learning
      Runs in Isaac Lab
    Tech stack
      Python
      Isaac Lab
      PyTorch
      MuJoCo
    Use cases
      Motion imitation training
      Pretrained policy playback
      Terrain aware motion
    Audience
      Robotics researchers
      ML engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Train a humanoid robot policy to imitate motion capture clips like flips or dances

USE CASE 2

Run a pretrained G1 robot policy to see it perform a movement immediately

USE CASE 3

Generate terrain-adjusted versions of motion clips using the included TCRS tool

USE CASE 4

Experiment with vision or terrain-aware perception for humanoid locomotion research

What is it built with?

PythonIsaac LabPyTorchMuJoCo

How does it compare?

mondo-robotics/pmtmaxucheng0/grok-auto-registerfacebookresearch/flowdec
Stars211211212
LanguagePythonPythonPython
Last pushed2026-06-22
MaintenanceMaintained
Setup difficultyhardmoderatehard
Complexity5/53/54/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a working Isaac Lab and Isaac Sim install plus a compatible GPU.

So what is it?

PMT, short for Perceptive Motion Tracking, is a research codebase for training a humanoid robot, the Unitree G1, to imitate human movements such as cartwheels and backflips using reinforcement learning, a training method where a program learns by trial and error inside a physics simulator. Training happens inside Isaac Lab, a robotics simulation platform, so this project does not work on its own: you need a working Isaac Lab installation first, and PMT installs into that existing environment. The repository includes scripts for training a policy, meaning the control program that decides how the robot's joints should move, and for playing back a trained policy to watch it perform. It also ships with about 25 pre-built training task setups for the G1 robot, sample motion capture clips for the robot to imitate, and several ready-made checkpoints, which are already trained models you can run immediately without training from scratch. Everything in PMT is controlled through configuration files rather than code changes. A task picks settings for things like which robot, which terrain, which motion, and which reward function to use, and the system automatically works out any settings that depend on those choices, refusing to run if you pick an invalid combination. The project also includes a separate tool called TCRS that can generate optimized versions of raw motion clips adjusted for a specific terrain, and it can additionally run on an alternative physics engine called mjlab for at least the simpler flat ground tasks. Because the pretrained models and demo motion files are large, they are stored separately from the main code, either on Hugging Face or Google Drive, with instructions for downloading and copying them into the right folders after cloning the repository. Getting this project running requires a working Isaac Lab and Isaac Sim setup, a compatible GPU, and Python 3.10 or newer, so it is intended for robotics researchers rather than casual users.

Copy-paste prompts

Prompt 1
Walk me through installing PMT inside an existing Isaac Lab environment
Prompt 2
Explain what the config axes like robot, terrain, and reward mean in this project
Prompt 3
Show me how to download and set up the pretrained G1 checkpoints for this repo
Prompt 4
Help me run a trained PMT policy on the mjlab backend instead of Isaac Lab

Frequently asked questions

What is pmt?

A research codebase for training a humanoid robot to imitate human motions like flips and dances using reinforcement learning in Isaac Lab.

What language is pmt written in?

Mainly Python. The stack also includes Python, Isaac Lab, PyTorch.

How hard is pmt to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is pmt for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.