AGILE: A Generic Isaac-Lab based Engine for humanoid loco-manipulation learning

Overview

AGILE provides a comprehensive reinforcement learning framework for training whole-body control policies with validated sim-to-real transfer capabilities. Built on NVIDIA Isaac Lab, this toolkit enables researchers and practitioners to develop loco-manipulation behaviors for humanoid robots.

Paper

AGILE targets Isaac Lab v3.0.0-beta2, Isaac Sim 6.0, Python 3.12, uv-based installation, and public RSL-RL 5.4.1 with a small AGILE patch.

Documentation

Booster T1 – Stand-Up		Booster T1 – Velocity Tracking
Sim	Real	Sim	Real
Unitree G1 – Velocity-Height Tracking		Unitree G1 – Sit-Down / Stand-Up
Sim	Real	Sim	Real
Unitree G1 – Teleoperation		Unitree G1 – Dancing
Sim	Real	Sim	Real

Key Features

• Multi-Robot Support: Validated on Booster T1 and Unitree G1 with sim-to-real transfer
• Teacher-Student Distillation: Train with privileged observations, distill to deployable student policies
• Self-Contained Tasks: Each task config is a single file; MDP term functions are shared via a common library
• Evaluation Framework: Random rollouts, deterministic scenarios, motion metrics, HTML reports, W&B integration
• Sim-to-MuJoCo Transfer: Generic framework for cross-simulator policy validation
• Remote Training: OSMO workflow support for cluster-based training, evaluation, and sweeps

Quick Start

Prerequisites: Python 3.12, uv, and a Linux workstation with an NVIDIA GPU. The first uv run resolves AGILE's pinned Isaac Lab 3.0.0-beta2, Isaac Sim 6.0, LEAPP, and RSL-RL dependencies.

# Train a velocity tracking policy
uv run scripts/train.py --task Velocity-T1-v0 --num_envs 2048 --headless

# Evaluate the trained policy
uv run scripts/eval.py --task Velocity-T1-v0 --num_envs 32 --checkpoint <path>

See the full documentation for installation details, training guides, task descriptions, and deployment instructions.

Office Hour and FAQ

We hosted a robotics livestream office hour providing an in-depth walkthrough of the AGILE framework.

• YouTube Recording
• FAQ Document

Contributing

Please see CONTRIBUTING.md for detailed information on how to contribute to this project.

License

License Information

This repository contains code under two open-source licenses:

Apache License 2.0

Most AGILE source code is licensed under the Apache License 2.0.

• Copyright holder: NVIDIA CORPORATION & AFFILIATES

BSD 3-Clause License

The RSL-RL compatibility patch in third_party/rsl_rl/patches/ is based on RSL_RL, which is licensed under the BSD 3-Clause License by ETH Zurich and contributors.

For complete license terms, see the LICENCE file.

Core Contributors

Huihua Zhao, Rafael Cathomen, Lionel Gulich, Efe Arda Ongan, Michael Lin, Shalin Jain, Wei Liu, Xinghao Zhu, Vishal Kulkarni, Soha Pouya, Yan Chang

Acknowledgments

We would like to acknowledge the following projects from which parts of the code in this repo are derived:

• Beyond Mimic
• RSL_RL
• Isaac Lab

Citation

If you use AGILE in your research, please cite:

@misc{zhao2026agilecomprehensiveworkflowhumanoid,
      title={AGILE: A Comprehensive Workflow for Humanoid Loco-Manipulation Learning},
      author={Huihua Zhao* and Rafael Cathomen* and Lionel Gulich and Wei Liu and Efe Arda Ongan and Michael Lin and Shalin Jain and Soha Pouya and Yan Chang},
      year={2026},
      eprint={2603.20147},
      archivePrefix={arXiv},
      primaryClass={cs.RO},
      url={https://arxiv.org/abs/2603.20147},
}