explaingit

nvlabs/protomotions

Analysis updated 2026-07-05 · repo last pushed 2026-07-04

⭐ Rising1,945PythonAudience · researcherComplexity · 5/5ActiveSetup · hard

TLDR

ProtoMotions is an NVIDIA toolkit that uses reinforcement learning to teach digital characters and humanoid robots how to move like real humans from recorded motion data, with support for deploying trained models directly onto real robot hardware.

Mindmap

mindmap
  root((repo))
    What it does
      Learns from human motion data
      Trains characters in simulation
      Deploys models to real robots
      Generates motion from text
    Tech stack
      Python
      Reinforcement Learning
      Physics Simulators
      NVIDIA GPUs
    Use cases
      Realistic game animation
      Train humanoid robots
      Robotics research
    Audience
      Robotics engineers
      Game developers
      Machine learning researchers
    Key features
      Modular task components
      Multiple simulator support
      Configurable robots
Click or tap to explore — scroll the page freely

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 virtual character to perform realistic animations driven by physics.

USE CASE 2

Teach a humanoid robot to walk and navigate difficult terrain using simulated training.

USE CASE 3

Generate new character motions from text prompts using the Kimodo model.

USE CASE 4

Learn and replicate complex human movements from large public motion datasets.

What is it built with?

PythonReinforcement LearningNVIDIA IsaacNVIDIA GPUs

How does it compare?

nvlabs/protomotionshughyau/academicforgefacebookresearch/fairchem
Stars1,9452,0952,173
LanguagePythonPythonPython
Last pushed2026-07-042026-07-05
MaintenanceActiveActive
Setup difficultyhardeasyhard
Complexity5/52/54/5
Audienceresearcherresearcherresearcher

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

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires high-end NVIDIA GPUs for training and familiarity with reinforcement learning environments and physics simulators.

NVIDIA software license, check the repository for specific terms on usage and redistribution.

In plain English

ProtoMotions is a toolkit that teaches digital characters and humanoid robots how to move like real humans. Instead of manually programming every joint movement, you give the system recordings of human motion, and it trains virtual characters or physical robots to replicate those actions. NVIDIA built this open-source framework to help researchers quickly prototype everything from animated characters to real walking robots. The framework works by placing a simulated character or robot in a virtual physics environment and using reinforcement learning to teach it how to match the movements from your motion data. The system practices over and over until it can reliably perform the motions. A standout feature is that you can train a robot in simulation and then deploy that trained model directly onto real hardware, the project demonstrates this by training a Unitree G1 robot to walk and perform various skills without needing any further real-world adjustment. It also supports generating new motions from text prompts via NVIDIA's Kimodo model. Researchers in animation, robotics, and machine learning are the primary audience. A robotics engineer could use it to teach a humanoid robot to navigate difficult terrain, while a game developer might use it to create realistic character animations driven by physics rather than scripted by hand. The framework can learn from large public motion datasets, with the README noting that it can train a character on over 40 hours of motion data in about 12 hours using four high-end GPUs. The project is designed to be highly modular. You can build custom tasks, like steering or navigating terrain, from standalone components rather than rewriting a whole environment from scratch. It supports multiple physics simulators so you can test how a trained policy behaves under different conditions, and adding a new robot involves providing a configuration file and a physical specification. The deployment pipeline exports a single model file, so frameworks controlling the real robot only need to feed it raw sensor data to get it moving.

Copy-paste prompts

Prompt 1
How do I set up ProtoMotions to train a virtual character using my own recorded human motion data?
Prompt 2
What are the steps to train a Unitree G1 robot in simulation with ProtoMotions and deploy the model directly onto the real robot hardware?
Prompt 3
How can I use the Kimodo model integration in ProtoMotions to generate character motions from text prompts?
Prompt 4
How do I create a custom navigation task in ProtoMotions using its modular standalone components?

Frequently asked questions

What is protomotions?

ProtoMotions is an NVIDIA toolkit that uses reinforcement learning to teach digital characters and humanoid robots how to move like real humans from recorded motion data, with support for deploying trained models directly onto real robot hardware.

What language is protomotions written in?

Mainly Python. The stack also includes Python, Reinforcement Learning, NVIDIA Isaac.

Is protomotions actively maintained?

Active — commit in last 30 days (last push 2026-07-04).

What license does protomotions use?

NVIDIA software license, check the repository for specific terms on usage and redistribution.

How hard is protomotions to set up?

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

Who is protomotions for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.