robosuite

library1.5.2pypypiunverified

robosuite is a modular simulation framework and benchmark for robot learning powered by MuJoCo physics. Version 1.5.2 (released 2025) adds diverse robot embodiments including humanoids, composite controllers, and photorealistic rendering. The API has undergone major breaking changes at v1.4 (new MuJoCo bindings) and v1.5 (controller restructuring).

ai-ml aws

pip install robosuite

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ROBOSUITE

robosuite

ai-mlpythonv1.5.2

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

make

✓ import robosuite as suite; env = suite.make('Lift', ...)

✗ from robosuite import make

make is a module-level function, not directly importable.

load_controller_config

✓ from robosuite.controllers import load_controller_config

✗ from robosuite.utils import load_controller_config

Moved to robosuite.controllers in v1.5.

GymWrapper

✓ from robosuite.wrappers import GymWrapper

✗ from robosuite.wrappers.gym_wrapper import GymWrapper

Old import path works but is deprecated, new path is robosuite.wrappers.

Minimal example creating a Lift environment with a Panda robot and OSC_POSE controller. No rendering.

import robosuite as suite from robosuite.controllers import load_controller_config config = load_controller_config(default_controller='OSC_POSE') env = suite.make( 'Lift', robots='Panda', controller_configs=config, has_renderer=False, has_offscreen_renderer=False, use_camera_obs=False, ) env.reset() for i in range(10): action = env.action_space.sample() obs, reward, done, info = env.step(action) if done: break env.close()

Debug

Known issues

breakingv1.4 switched from old mujoco-py bindings to DeepMind's mujoco (pip install mujoco). Old environments are incompatible without migration.

fix

Reinstall with `pip install robosuite` which now depends on `mujoco>=2.3.0`. Remove any old mujoco-py installation.

affects: 1.4+

breakingv1.5 changed controller configuration. `load_controller_config` moved to `robosuite.controllers`. `OSC_POSE` replaces old OSC controller.

fix

Use `from robosuite.controllers import load_controller_config` and specify `default_controller='OSC_POSE'`.

affects: 1.5+

gotcha`env.reset()` returns only observations (no info dict) in most environments. Many users expect a tuple `(obs, info)`.

fix

Check documentation: `obs = env.reset()`. Info is only available in some wrappers.

affects: all

gotchaRendering requires `has_renderer=True` and a `viewer` installation. On headless systems use `has_offscreen_renderer=True` with `render_camera`.

fix

Set `has_renderer=False, has_offscreen_renderer=True` and collect images via `obs['agentview_image']`.

affects: all

Upgrade

Version history

1.5.2latest on PyPI · released Dec 24, 2025

Audit

Dependencies

mujocorequiredNew MuJoCo bindings (v1.4+). Old versions used old mujoco-py. Must be pip-installable.

Agent activity

79 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/ARISE-Initiative/robosuite ↗

packagehttps://pypi.org/project/robosuite/ ↗

homepagehttps://robosuite.ai ↗