Qingwei Ben*, Feiyu Jia*, Jia Zeng, Junting Dong, Dahua Lin, Jiangmiao Pang
* Equal Controlbution
Shanghai Artificial Intelligence Laboratory & The Chinese University of Hong Kong
- [2025-02] We release the paper and demos of HOMIE.
- [2025-02] We open all of the resources of HOMIE
HOMIE enables a single operator to precisely and efficiently control a humanoid robot's full-body movements for diverse loco-manipulation tasks. Integrated into simulation environments, our cockpit also enables seamless teleoperation in virtual settings. Specifically, we introduce three core techniques to our RL-based training framework: upper-body pose curriculum, height tracking reward, and symmetry utilization. These components collectively enhance the robot's physical agility, enabling robust walking, rapid squatting to any required heights, and stable balance maintenance during dynamic upper-body movements, thereby significantly expanding the robot's operational workspace beyond existing solutions. Unlike previous whole-body control methods that depend on motion priors derived from motion capture (MoCap) data, our framework eliminates this dependency, resulting in a more efficient pipeline.
Our hardware system features isomorphic exoskeleton arms, a pair of motion-sensing gloves, and a pedal. The pedal design for locomotion command acquisition liberates the operator's upper body, enabling simultaneous acquisition of upper-body poses. Since the exoskeleton arms are isomorphic to the controlled robot and each glove has 15 degrees of freedom (DoF), which is more than most existing dexterous hands, we can directly set upper-body joint positions from the exoskeleton readings, dispensing with IK and achieving faster and more accurate teleoperation. Moreover, our gloves can be detached from the arms, allowing them to be reused in systems isomorphic to different robots. The total cost of the hardware system is only $0.5k, which is significantly lower than that of MoCap devices.
This repository contains three key components of HOMIE:
- HomieRL: A novel reinforcement learning (RL)-based training framework that enables different kinds of humanoid robots to walk and squat robustly under any continuously changing upper-body poses.
- HomieHardware: It contains all necessary files to reimplement our hardware system, including design files, PCB principle files, and keil code for PCBs.
- HomieDeploy: It contains all deployment code for both PC that connected to our hardware system and the Unitree G1 with Dex3 hands.
We separate these parts into three different sub-directories, you can view them as three independent repositories. Each sub-directory has its own README, which describes their usage ways and functions. HOMIE is fully open-sourced, however, it is strictly forbidden to use HOMIE for any commercial purposes.
We recommend to use our code under the following environment:
- Ubuntu 20.04/22.04 Operating System
- IsaacGym Preview 4.0
- NVIDIA GPU (RTX 2070 or higher)
- NVIDIA GPU Driver (recommended version 535.183)
- Conda
- Python 3.8
- Hardware
- Unitree G1 with Dex3 Hands
- Realsense D455 * 1
- Realsense D435 * 2
You should first clone this repository to your Ubuntu computer by running:
https://github.com/OpenRobotLab/Homie.git
Then you can follow the README.md in each sub-repostory to install all three parts or just one of them.
If you have any questions about the usage of this repository, please feel free to drop an e-mail at [email protected], we will respond to it as soon as possible.
If you find our work helpful, please cite:
@article{ben2024homie,
title={HOMIE: Humanoid Loco-Manipulation with Isomorphic Exoskeleton Cockpit},
author={Qingwei Ben, Feiyu Jia, Jia Zeng, Junting Dong, Dahua Lin, Jiangmiao Pang},
journal={arXiv preprint arXiv:2502.13013},
year={2025}
}
- Release the paper with demos.
- Release all necessary code.
- Release training code for more robots.
- Upgrade the low-level control policy for more complex terrains and more robots.
All code of HOMIE is under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License . It is strictly forbidden to use it for commercial purposes before asking our team.
- RSL_RL: We use
rsl_rl
library to train the control policies for legged robots. - Legged_gym: We use
legged_gym
library to train the control policies for legged robots. - HIMLoco: We use
HIMLoco
library as our codebase. - Walk-These-Ways: Our robot deployment code is based on
walk-these-ways
. - Unitree SDK2: We use
Unitree SDK2
library to control the robot. - HomunCulus: Our glove design refers to the principle of
HomunCulus
such as usingHall sensors
.