Paper | Project Page | AirExo-2 Codebase
Authors (for RISE-2): Chenxi Wang, Hongjie Fang, Shangning Xia, Jingjing Chen, Hao-Shu Fang, Cewu Lu.
This repository contains the full source codes of the RISE-2 policy.
- [Aug 29, 2025] Fix a bug in Spatial Aligner. After the fix, the model shows improved perfomance compared to the version in paper. See CHANGELOG for a detailed report.
- [May 15, 2025] Initial release.
Please follow the installation guide to install the rise2
conda environments and the dependencies, as well as the real robot environments.
Please follow the configuration guide to configurate the parameters and environmental constants.
Please calibrate the camera(s) with the robot before data collection and evaluation to ensure correct spatial transformations between camera(s) and the robot. We use the calibration process in the AirExo-2 codebase in this paper. Please refer to calibration guide for more details.
We use AirExo-2 to collect both teleoperated and in-the-wild demonstrations. This repository also supports single-arm platform. For more details about data collection, please refer to the data collection guide.
Modify the arguments in command_train.sh
, then
conda activate rise2
bash command_train.sh
Here are the argument explanations in the training process:
--data_path [data_path]
: path to load the data.--ckpt_dir [ckpt_path]
: path to save the checkpoints.--config [config_path]
: path to the configuration files.- (optional)
--resume_ckpt [ckpt_file]
: path to a checkpoint file to resume training. - (optional)
--resume_step [step]
: the step number from which to resume training.
Here we provide the sample real-world evaluation code based on the hardwares (Flexiv Rizon 4 robotic arms, Robotiq 2F-85 grippers, Intel RealSense camera). For other hardware settings, please follow the deployment guide to modify the evaluation script. We also provide a remote evaluation script for the server-client architecture.
For local evaluation, modify the arguments in command_eval_local.sh
, then
conda activate rise2
bash command_eval_local.sh
For remote evaluation, modify the arguments in command_eval_remote.sh
and command_eval_server.sh
, then first execute the server script on the remote server:
conda activate rise2
bash command_eval_server.sh
Then execute the client script on the local machine:
conda activate rise2
bash command_eval_remote.sh
Here are the argument explanations in the deployment process:
--type [local/remote]
: local or remote evaluation.--ckpt [ckpt_path]
: path to the checkpoint to be evaluated (required for local evaluation & remote server).--calib [calib_dir]
: the calibration directory.--config [config_path]
: path to the configuration files.--ip [ip]
: the IP address of the remote server (required for both server and client of the remote evaluation).--port [port]
: the port of the remote server (required for both server and client of the remote evaluation).
- Our policy codebase is built upon RISE, with the original CC-BY-NC-SA 4.0 license.
- Our diffusion module is adapted from Diffusion Policy. This part is under MIT License.
- Our transformer module is adapted from ACT, which used DETR in their implementations. The DETR part is under APACHE 2.0 License.
- Our Minkowski ResNet observation encoder is adapted from the examples of the MinkowskiEngine repository. This part is under MIT License.
- Our temporal ensemble implementation is inspired by HATO.
- Our remote evaluation implementation is adapted from openpi. This part is under APACHE 2.0 License.
@article{fang2025airexo,
title = {AirExo-2: Scaling up Generalizable Robotic Imitation Learning with Low-Cost Exoskeletons},
author = {Hongjie Fang and Chenxi Wang and Yiming Wang and Jingjing Chen and Shangning Xia and Jun Lv and Zihao He and Xiyan Yi and Yunhan Guo and Xinyu Zhan and Lixin Yang and Weiming Wang and Cewu Lu and Hao-Shu Fang},
journal = {arXiv preprint arXiv:2503.03081},
year = {2025}
}
@inproceedings{wang2024rise,
title = {RISE: 3D Perception Makes Real-World Robot Imitation Simple and Effective},
author = {Wang, Chenxi and Fang, Hongjie and Fang, Hao-Shu and Lu, Cewu},
booktitle = {2024 IEEE/RSJ International Conference on Intelligent Robots and Systems (IROS)},
year = {2024},
pages = {2870-2877},
doi = {10.1109/IROS58592.2024.10801678}}
}
RISE-2 (including data and codebase) by Chenxi Wang, Hongjie Fang, Shangning Xia, Jingjing Chen, Hao-Shu Fang, Cewu Lu is licensed under CC BY-NC-SA 4.0