Skip to main content

robosuite: A Modular Simulation Framework and Benchmark for Robot Learning

Project description

robosuite

[Homepage][White Paper][Documentations][ARISE Initiative]


Latest Updates

  • [10/28/2024] v1.5: Added support for diverse robot embodiments (including humanoids), custom robot composition, composite controllers (including whole body controllers), more teleoperation devices, photo-realistic rendering. [release notes] [documentation]

  • [11/15/2022] v1.4: Backend migration to DeepMind's official MuJoCo Python binding, robot textures, and bug fixes :robot: [release notes] [documentation]

  • [10/19/2021] v1.3: Ray tracing and physically based rendering tools :sparkles: and access to additional vision modalities 🎥 [video spotlight] [release notes] [documentation]

  • [02/17/2021] v1.2: Added observable sensor models :eyes: and dynamics randomization :game_die: [release notes]

  • [12/17/2020] v1.1: Refactored infrastructure and standardized model classes for much easier environment prototyping :wrench: [release notes]


robosuite is a simulation framework powered by the MuJoCo physics engine for robot learning. It also offers a suite of benchmark environments for reproducible research. The current release (v1.5) features support for diverse robot embodiments (including humanoids), custom robot composition, composite controllers (including whole body controllers), more teleoperation devices, photo-realistic rendering. This project is part of the broader Advancing Robot Intelligence through Simulated Environments (ARISE) Initiative, with the aim of lowering the barriers of entry for cutting-edge research at the intersection of AI and Robotics.

Data-driven algorithms, such as reinforcement learning and imitation learning, provide a powerful and generic tool in robotics. These learning paradigms, fueled by new advances in deep learning, have achieved some exciting successes in a variety of robot control problems. However, the challenges of reproducibility and the limited accessibility of robot hardware (especially during a pandemic) have impaired research progress. The overarching goal of robosuite is to provide researchers with:

  • a standardized set of benchmarking tasks for rigorous evaluation and algorithm development;
  • a modular design that offers great flexibility in designing new robot simulation environments;
  • a high-quality implementation of robot controllers and off-the-shelf learning algorithms to lower the barriers to entry.

This framework was originally developed in late 2017 by researchers in Stanford Vision and Learning Lab (SVL) as an internal tool for robot learning research. Now, it is actively maintained and used for robotics research projects in SVL, the UT Robot Perception and Learning Lab (RPL) and NVIDIA Generalist Embodied Agent Research Group (GEAR). We welcome community contributions to this project. For details, please check out our contributing guidelines.

Robosuite offers a modular design of APIs for building new environments, robot embodiments, and robot controllers with procedural generation. We highlight these primary features below:

  • standardized tasks: a set of standardized manipulation tasks of large diversity and varying complexity and RL benchmarking results for reproducible research;
  • procedural generation: modular APIs for programmatically creating new environments and new tasks as combinations of robot models, arenas, and parameterized 3D objects. Check out our repo robosuite_models for extra robot models tailored to robosuite.
  • robot controllers: a selection of controller types to command the robots, such as joint-space velocity control, inverse kinematics control, operational space control, and whole body control;
  • teleoperation devices: a selection of teleoperation devices including keyboard, spacemouse and MuJoCo viewer drag-drop;
  • multi-modal sensors: heterogeneous types of sensory signals, including low-level physical states, RGB cameras, depth maps, and proprioception;
  • human demonstrations: utilities for collecting human demonstrations, replaying demonstration datasets, and leveraging demonstration data for learning. Check out our sister project robomimic;
  • photorealistic rendering: integration with advanced graphics tools that provide real-time photorealistic renderings of simulated scenes, including support for NVIDIA Isaac Sim rendering.

Citation

Please cite robosuite if you use this framework in your publications:

@inproceedings{robosuite2020,
  title={robosuite: A Modular Simulation Framework and Benchmark for Robot Learning},
  author={Yuke Zhu and Josiah Wong and Ajay Mandlekar and Roberto Mart\'{i}n-Mart\'{i}n and Abhishek Joshi and Soroush Nasiriany and Yifeng Zhu and Kevin Lin},
  booktitle={arXiv preprint arXiv:2009.12293},
  year={2020}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robosuite-1.5.1.tar.gz (150.9 MB view details)

Uploaded Source

Built Distribution

robosuite-1.5.1-py3-none-any.whl (152.0 MB view details)

Uploaded Python 3

File details

Details for the file robosuite-1.5.1.tar.gz.

File metadata

  • Download URL: robosuite-1.5.1.tar.gz
  • Upload date:
  • Size: 150.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for robosuite-1.5.1.tar.gz
Algorithm Hash digest
SHA256 58ee509878ca084f7658aae3a58ef363b44a8fbdcc92cd7bd349977cdc476029
MD5 7468282d06f58bb20b4cdc806b8bde16
BLAKE2b-256 f37807c2eb013cf94737745f4084c71d05c921e449a3bc4e72a662010331cf34

See more details on using hashes here.

Provenance

The following attestation bundles were made for robosuite-1.5.1.tar.gz:

Publisher: update-pypi.yaml on ARISE-Initiative/robosuite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file robosuite-1.5.1-py3-none-any.whl.

File metadata

  • Download URL: robosuite-1.5.1-py3-none-any.whl
  • Upload date:
  • Size: 152.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for robosuite-1.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 39810a9e9f193455fcb13a9b4846424abef77481ac3091892c2077c88dcdc153
MD5 86798e3c438268390bdabf28ae3437f8
BLAKE2b-256 f41582093cadf23811463d0b52ec6745949356b66badf6e25bee64ec82aa8689

See more details on using hashes here.

Provenance

The following attestation bundles were made for robosuite-1.5.1-py3-none-any.whl:

Publisher: update-pypi.yaml on ARISE-Initiative/robosuite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page