Open Source RoboticsRobots, software & field notes

robosuite

Based on published sources · Not tested by us ·

Overview

MuJoCo-based robot-learning environments with configurable robots, grippers, controllers and observations; the reviewed v1.5.2 setup requires matching rendering and action conventions. [S001]

robosuite provides MuJoCo-based simulation environments for robot learning. Its modular interface combines robots, grippers, controllers, arenas and objects into tasks, with particular emphasis on manipulation. The reviewed source is v1.5.2; the v1.5 family adds broader embodiments and composite controllers. These capabilities describe the framework, not a demonstrated policy result on physical hardware. [S001] [S002] [S007]

Specifications

DetailDescription
Intended usersRobot-learning researchers building controlled simulation experiments
Editorial assessment [S001] · Checked 2026-10-01
Required softwareMuJoCo >=3.3.0; mink ==0.0.5; qpsolvers[quadprog] >=4.3.1; Additional dependencies for optional devices and integrations
Reported by source [S005] [S006] · Checked 2026-10-01
InstallationUse an isolated Python environment; the guide suggests Python 3.10. Install the selected release and run the documented random-action demo; macOS default viewer uses mjpython.
Editorial sequence; no installation or demo executed.
Editorial assessment [S005] · Checked 2026-10-01
UsesConfigure robots, grippers and controllers for a manipulation task; Choose low-dimensional or camera observations; Collect or replay demonstrations; Implement and register custom composite controllers
Reported by source [S001] [S007] [S008] · Checked 2026-10-01
File formatsNot known
Development statusDocumented setup available
Research classification from documented artifacts/workflow, not our reproduction or production qualification.
Editorial assessment [S001] · Checked 2026-10-01

3D preview

A robot-part preview is not applicable to this software project profile.

Installation and use

Choose a release and a rendering route

The installation guide officially supports macOS and Linux and recommends an isolated Python environment, with Python 3.10 in its Conda example. The selected package metadata requires MuJoCo 3.3.0 or newer, pins mink to 0.0.5 and lists additional numerical and rendering dependencies. Its broad Python metadata alone does not establish that every Python 3 version works with the full dependency set. Record the actual resolved versions for an experiment. [S005] [S006]

The documented first check is the random-action demo. On macOS, the default MuJoCo viewer uses mjpython rather than the ordinary Python launcher. The same guide includes Windows troubleshooting, but its official support statement names macOS and Linux. Optional devices and integrations need additional dependencies. This review did not install the package or run its demo. [S005]

Observations and actions are configuration choices

The environment guide constructs a TwoArmLift task with Sawyer and Panda robots and a composite controller loaded through load_composite_controller_config. Robots, grippers, robot arrangement and controller configuration can all change. A controller change can also change the action space; an action vector from one configuration should not be assumed to mean the same thing in another. [S007]

For a first integration, use the environment's action_spec bounds and the documented reset/step loop. Observations are dictionaries rather than one universal flat vector. They can contain proprioception, object state, RGB images and depth, depending on the enabled modalities. Record those choices with the policy configuration so a comparison uses the same information at training and evaluation. This recording recommendation is an editorial reproducibility step. [S007]

The image-based example enables off-screen rendering and camera observations while disabling the on-screen renderer. A headless process therefore still needs the rendering route appropriate to its selected observations. The default image convention is OpenGL-style, described upstream as flipped; IMAGE_CONVENTION can switch to OpenCV-style output. That difference matters when reusing camera preprocessing. [S007]

Success and termination are different signals

The guide distinguishes sparse task-success rewards from shaped rewards. It also states that reaching the success criterion does not terminate the episode: environments continue to the configured horizon. A comparison that treats the returned termination signal as a success flag would therefore measure a different quantity. Preserve the reward setting, success definition, control frequency and horizon with evaluation results. No success rate or timing measurement was produced here. [S007]

Custom composite controllers require more than a configuration name. The extension guide subclasses a composite controller, registers it, implements its behavior, imports the class and supplies matching configuration. Its third-party example illustrates the route; it is not evidence that an arbitrary external controller is compatible. [S008]

The root license is MIT and separately identifies included MuJoCo portions under Apache-2.0. It does not establish blanket rights to every external model, renderer or dataset a user might select. This entry covers the simulation framework and its random-action setup route, without downloading a policy or demonstration dataset or claiming hardware transfer. [S003] [S005]

Source files and licenses

Available project sources support research coverage; complete build and commercial qualification remain separate.

LayerAvailability / license
softwareavailable · MIT
Root license separately identifies included MuJoCo portions under Apache-2.0; external dependencies and assets retain their own terms. [S003]
documentationavailable · License not fully assessed
Source documentation available; separate documentation-wide rights not established. [S004] [S005]

This profile selects the environment framework and random-action setup route, not a pretrained policy or demonstration dataset.

References

Links identify the documentation and revisions used in this profile. Access dates record when each source was retrieved.

  1. S001 · ARISE-Initiative / project contributors
    Upstream project overview
    Accessed 2026-10-01 · README.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  2. S002 · ARISE-Initiative / project contributors
    Repository revision and release metadata
    Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  3. S003 · ARISE-Initiative / project contributors
    Repository license
    Accessed 2026-10-01 · LICENSE
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  4. S004 · ARISE-Initiative / project contributors
    Pinned repository artifact inventory
    Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 archive file inventory
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  5. S005 · ARISE-Initiative / project contributors
    robosuite v1.5.2: docs/installation.md
    Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / docs/installation.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  6. S006 · ARISE-Initiative / project contributors
    robosuite v1.5.2: setup.py
    Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / setup.py
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  7. S007 · ARISE-Initiative / project contributors
    robosuite v1.5.2: docs/modules/environments.md
    Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / docs/modules/environments.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

  8. S008 · ARISE-Initiative / project contributors
    robosuite v1.5.2: docs/tutorials/add_controller.md
    Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / docs/tutorials/add_controller.md
    Source notes

    Source text inspected for the cited scoped claims; see profile claim notes.

Research and review details

Source research only; no installation, physical build or performance test performed. No affiliate links added.

Profile edited 2026-10-01 · Sources checked 2026-10-01 · Next review target 2026-10-31

Revision: 824ac14cefcfb7ec125fe5eb2e0bad7364466154 (release v1.5.2). Software repository activity recorded 2025-12-23 [S002]

Correction guidance · Discussion is not enabled · Profile format 0.6.0-draft.1

Change history