{"id":21880,"library":"robosuite","title":"robosuite","description":"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).","status":"active","version":"1.5.2","language":"python","source_language":"en","source_url":"https://github.com/ARISE-Initiative/robosuite","tags":["simulation","robotics","reinforcement-learning","mujoco","benchmark"],"install":[{"cmd":"pip install robosuite","lang":"bash","label":"PyPi"}],"dependencies":[{"reason":"New MuJoCo bindings (v1.4+). Old versions used old mujoco-py. Must be pip-installable.","package":"mujoco","optional":false}],"imports":[{"note":"make is a module-level function, not directly importable.","wrong":"from robosuite import make","symbol":"make","correct":"import robosuite as suite; env = suite.make('Lift', ...)"},{"note":"Moved to robosuite.controllers in v1.5.","wrong":"from robosuite.utils import load_controller_config","symbol":"load_controller_config","correct":"from robosuite.controllers import load_controller_config"},{"note":"Old import path works but is deprecated, new path is robosuite.wrappers.","wrong":"from robosuite.wrappers.gym_wrapper import GymWrapper","symbol":"GymWrapper","correct":"from robosuite.wrappers import GymWrapper"}],"quickstart":{"code":"import robosuite as suite\nfrom robosuite.controllers import load_controller_config\n\nconfig = load_controller_config(default_controller='OSC_POSE')\nenv = suite.make(\n    'Lift',\n    robots='Panda',\n    controller_configs=config,\n    has_renderer=False,\n    has_offscreen_renderer=False,\n    use_camera_obs=False,\n)\nenv.reset()\nfor i in range(10):\n    action = env.action_space.sample()\n    obs, reward, done, info = env.step(action)\n    if done:\n        break\nenv.close()","lang":"python","description":"Minimal example creating a Lift environment with a Panda robot and OSC_POSE controller. No rendering."},"warnings":[{"fix":"Reinstall with `pip install robosuite` which now depends on `mujoco>=2.3.0`. Remove any old mujoco-py installation.","message":"v1.4 switched from old mujoco-py bindings to DeepMind's mujoco (pip install mujoco). Old environments are incompatible without migration.","severity":"breaking","affected_versions":"1.4+"},{"fix":"Use `from robosuite.controllers import load_controller_config` and specify `default_controller='OSC_POSE'`.","message":"v1.5 changed controller configuration. `load_controller_config` moved to `robosuite.controllers`. `OSC_POSE` replaces old OSC controller.","severity":"breaking","affected_versions":"1.5+"},{"fix":"Check documentation: `obs = env.reset()`. Info is only available in some wrappers.","message":"`env.reset()` returns only observations (no info dict) in most environments. Many users expect a tuple `(obs, info)`.","severity":"gotcha","affected_versions":"all"},{"fix":"Set `has_renderer=False, has_offscreen_renderer=True` and collect images via `obs['agentview_image']`.","message":"Rendering requires `has_renderer=True` and a `viewer` installation. On headless systems use `has_offscreen_renderer=True` with `render_camera`.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install mujoco","cause":"Missing new MuJoCo bindings (v1.4+ requirement).","error":"ModuleNotFoundError: No module named 'mujoco'"},{"fix":"import robosuite as suite; env = suite.make(...)","cause":"Trying to import `make` directly instead of using `robosuite.make()`.","error":"AttributeError: module 'robosuite' has no attribute 'make'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}