Skip to content

Open-sourced code for "HOMIE: Humanoid Loco-Manipulation with Isomorphic Exoskeleton Cockpit".

License

Notifications You must be signed in to change notification settings

XChen-SU/OpenHomie

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


HOMIE: Humanoid Loco-Manipulation with Isomorphic Exoskeleton Cockpit (RL)

Qingwei Ben*, Feiyu Jia*, Jia Zeng, Junting Dong, Dahua Lin, Jiangmiao Pang
* Equal Controlbution
Shanghai Artificial Intelligence Laboratory & The Chinese University of Hong Kong

arXiv

🤖 Demo

demo

🔥 News

  • [2025-02] We release the paper and demos of HOMIE.
  • [2025-02] We open all of the resources of HOMIE

📋 Contents

🏠 About

framework

This repository is an official implementation of "HOMIE: Humanoid Loco-Manipulation with Isomorphic Exoskeleton Cockpit", which is a novel humanoid teleoperation cockpit composed of a humanoid loco-manipulation policy and an exoskeleton-based hardware system.

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.

📚 Usage

Prerequisites

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

Installation

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.

🔗 Citation

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}
}

📝 TODO List

  • 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.

📄 License

All code of HOMIE is under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License Creative Commons License. It is strictly forbidden to use it for commercial purposes before asking our team.

👏 Acknowledgements

  • 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 using Hall sensors.

About

Open-sourced code for "HOMIE: Humanoid Loco-Manipulation with Isomorphic Exoskeleton Cockpit".

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 84.9%
  • Python 14.6%
  • CMake 0.5%