Welcome to LocoMuJoCo!

https://github.com/robfiras/loco-mujoco/assets/69359729/bd2a219e-ddfd-4355-8024-d9af921fb92a https://github.com/robfiras/loco-mujoco/actions/workflows/continuous_integration.yml/badge.svg?branch=dev https://readthedocs.org/projects/loco-mujoco/badge/?version=latest https://img.shields.io/badge/License-MIT-yellow.svg https://img.shields.io/pypi/v/loco-mujoco https://img.shields.io/badge/Discord-Join%20Us-7289DA?style=flat&logo=discord&logoColor=white

Latest News

🚀 Since Release: v1.0

LocoMuJoCo now supports MJX and includes new JAX algorithms, expanded environments, and over 22,000 datasets!

Overview

LocoMuJoCo is an imitation learning benchmark tailored for whole-body control. It includes a diverse range of environments—quadrupeds, humanoids, and (musculo-)skeletal human models—each equipped with comprehensive datasets (22k+ samples per humanoid).

While designed for imitation learning, it also supports pure reinforcement learning with custom reward classes.

_images/main_lmj.gif

Key Advantages

  • ✅ Supports MuJoCo (single) and MJX (parallel) environments

  • ✅ Includes 12 humanoid + 4 quadruped environments, with 4 biomechanical human models

  • ✅ Clean, single-file JAX algorithms: PPO, GAIL, AMP, DeepMimic

  • 22,000+ motion capture datasets (AMASS, LAFAN1, native)

  • Robot-to-robot retargeting

  • ✅ Trajectory comparison metrics (e.g., DTW, Fréchet distance) implemented in JAX

  • Gymnasium interface

  • ✅ Built-in domain and terrain randomization

  • Modular design: easily swap components (observations, rewards, terminal handlers, etc.)

  • ✅ Comprehensive [documentation](https://loco-mujoco.readthedocs.io/)