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
| Detail | Description |
|---|---|
| Intended users | Robot-learning researchers building controlled simulation experiments Editorial assessment [S001] · Checked 2026-10-01 |
| Required software | MuJoCo >=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 |
| Installation | Use 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 |
| Uses | Configure 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 formats | Not known |
| Development status | Documented 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.
| Layer | Availability / license |
|---|---|
| software | available · MIT Root license separately identifies included MuJoCo portions under Apache-2.0; external dependencies and assets retain their own terms. [S003] |
| documentation | available · 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.
- S001 · ARISE-Initiative / project contributors
Upstream project overview
Accessed 2026-10-01 · README.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S002 · ARISE-Initiative / project contributors
Repository revision and release metadata
Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154Source notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S003 · ARISE-Initiative / project contributors
Repository license
Accessed 2026-10-01 · LICENSESource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S004 · ARISE-Initiative / project contributors
Pinned repository artifact inventory
Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 archive file inventorySource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S005 · ARISE-Initiative / project contributors
robosuite v1.5.2: docs/installation.md
Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / docs/installation.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S006 · ARISE-Initiative / project contributors
robosuite v1.5.2: setup.py
Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / setup.pySource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S007 · ARISE-Initiative / project contributors
robosuite v1.5.2: docs/modules/environments.md
Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / docs/modules/environments.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
- S008 · ARISE-Initiative / project contributors
robosuite v1.5.2: docs/tutorials/add_controller.md
Accessed 2026-10-01 · 824ac14cefcfb7ec125fe5eb2e0bad7364466154 / docs/tutorials/add_controller.mdSource notes
Source text inspected for the cited scoped claims; see profile claim notes.
Correction guidance · Discussion is not enabled · Profile format 0.6.0-draft.1