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).
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
muslpy 3.10–3.95 runs
build_error
glibcpy 3.10–3.95 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
make is a module-level function, not directly importable.
import robosuite as suite; env = suite.make('Lift', ...)
Moved to robosuite.controllers in v1.5.
from robosuite.controllers import load_controller_config
Old import path works but is deprecated, new path is robosuite.wrappers.
from robosuite.wrappers import GymWrapper
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()
Upgrade
Version history
Breaking-change detection hasn't run for this library yet.
Audit
Security & dependencies
CVE tracking and dependency tree are planned for a later release.