Paper | Website | Documentation
FurnitureBench is the real-world furniture assembly benchmark, which aims at providing a reproducible and easy-to-use platform for long-horizon complex robotic manipulation.
This is a fork of FurnitureBench. The main difference in this fork is that it utilizes SAPIEN as the simulator for FurnitureSim with support for Python 3.9+. (For this installation, please refer to FurnitureSim section) and also guide and tutorials in the online document of the original author.
It features
- Long-horizon complex manipulation tasks
- Standardized environment setup
- Python-based robot control stack
- FurnitureSim: a simulated environment
- Large-scale teleoperation dataset (200+ hours)
Please check out our website for more details.
We elaborate on the real-world environment setup guide and tutorials in our online document.
FurnitureSim in this fork is a simulator based on SAPIEN. FurnitureSim works on any Linux and Python 3.9. Original FurnitureSim is a simulator based on Isaac Gym.
For the installation of FurnitureSim of this branch, please download the wheels in releases of this repository (Customized SAPIEN simulator with fixed URDF loader) and use pip
to install.
You might not need CUDA for the installation of SAPIEN but NVIDIA GPU is needed since we enforce GPU simulation for FurnitureSim. In addition, the NVIDIA GPU driver should meet some requirements. Please find the details on this page
After installation of SAPIEN, in the folder of this repo, run:
pip install -e .
- Simulator with Data Collection
- Successful furniture assembly with handcrafted scripts.
- More realistic Rasterization-based Render (New Shader)
- Removal of Isaacgym in bash scripts
- Recording during the simulation
- Evaluation with approaches from the original FurnitureBench
- Test reinforcement learning (fine-tuning) in the environment
If you find FurnitureBench useful for your research, please cite this work:
@inproceedings{heo2023furniturebench,
title={FurnitureBench: Reproducible Real-World Benchmark for Long-Horizon Complex Manipulation},
author={Minho Heo and Youngwoon Lee and Doohyun Lee and Joseph J. Lim},
booktitle={Robotics: Science and Systems},
year={2023}
}
- Polymetis: https://github.com/facebookresearch/polymetis
- BC: Youngwoon's robot-learning repo.
- IQL: https://github.com/ikostrikov/implicit_q_learning
- R3M: https://github.com/facebookresearch/r3m
- VIP: https://github.com/facebookresearch/vip
- Factory: https://github.com/NVIDIA-Omniverse/IsaacGymEnvs/blob/main/docs/factory.md
- OSC controller references: https://github.com/StanfordVL/perls2 and https://github.com/ARISE-Initiative/robomimic and https://github.com/ARISE-Initiative/robosuite