Skip to content
프로젝트

tayalmanan28/MuJoCo-Tutorial has 385 GitHub stars and 46 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-21 15:18 UTC. Last push 2026-05-21.

이 수치를 측정하는 방법

측정된 스타 증가

in 24h
0
in 7 days
기록 수집 중
in 15 days
기록 수집 중
in 1 month
기록 수집 중

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

소개

Tutorial on how to get started with MuJoCo Simulation Platform. MuJoCo stands for Multi-Joint dynamics with Contact.

학습

README.md

Original

MuJoCo Tutorial Logo

MuJoCo Tutorial 🤖

A modern tutorial for getting started with MuJoCo — a fast, accurate physics engine for robotics, biomechanics, and reinforcement learning.

MuJoCo is open-source (Apache 2.0) and maintained by Google DeepMind. Since v3.0, it includes GPU-accelerated simulation via MJX.

Open In Colab


Installation 🚀

MuJoCo is a pure Python package — no license keys, no system dependencies:

pip install mujoco gymnasium[mujoco] mediapy

That's it. For interactive visualization you also need a display (or use offscreen rendering in notebooks).

Optional: Conda environment

conda create -n mujoco-tut python=3.11
conda activate mujoco-tut
pip install -r requirements.txt

Quickstart

import mujoco
import mujoco.viewer

model = mujoco.MjModel.from_xml_string("""
<mujoco>
  <worldbody>
    <light pos="0 0 3" dir="0 0 -1"/>
    <geom type="plane" size="5 5 0.1"/>
    <body pos="0 0 2">
      <joint type="free"/>
      <geom type="sphere" size="0.2" rgba="1 0 0 1"/>
    </body>
  </worldbody>
</mujoco>
""")
data = mujoco.MjData(model)

# Launch interactive viewer
mujoco.viewer.launch(model, data)

For headless/notebook rendering, see examples/offscreen_rendering.py.


Preview

Trajectory Tracking LQR Cart-Pole

Impedance Control Pick and Place

Left to right: trajectory tracking, LQR balancing, impedance control, pick-and-place


Contents

Example Description
examples/projectile.py Projectile with drag force
examples/pendulum_control.py PD control of a pendulum
examples/double_pendulum.py Double pendulum swing-up control
examples/hopper.py 2D hopper with open-loop jumping
examples/inverse_kinematics.py Damped least-squares IK with Jacobians
examples/contact_forces.py Reading contact info & forces
examples/domain_randomization.py Varying physics params across episodes
examples/menagerie_robot.py Loading robots from MuJoCo Menagerie
examples/mjx_parallel.py GPU-parallel sim with MJX (JAX)
examples/gymnasium_env.py Using Gymnasium's MuJoCo envs
examples/offscreen_rendering.py Headless rendering & video export
examples/trajectory_tracking.py Arm follows circular path (task-space PD)
examples/operational_space_control.py Full dynamics compensation in task space
examples/lqr_control.py LQR cart-pole balancing (linearization + Riccati)
examples/impedance_control.py Compliant end-effector (spring-damper behavior)
examples/locomotion_controller.py Hopper FSM locomotion (finite state machine)
examples/pick_and_place.py Gripper pick-and-place with waypoint sequencing
examples/record_playback.py Save/load trajectories (record & replay)

Base class

mujoco_base.py provides a minimal base class for building custom simulations:

from mujoco_base import MuJoCoBase

class MySim(MuJoCoBase):
    def reset(self):
        pass  # set initial conditions

    def controller(self, model, data):
        data.ctrl[0] = ...  # your control logic

sim = MySim("my_model.xml")
sim.run()  # interactive viewer
# or
frames = sim.run_headless(duration=5.0)  # offscreen

Tutorial Notebooks

Step-by-step Jupyter notebooks (run in Colab or locally):

Notebook Topic
tutorial/00_what_is_mujoco.ipynb Start here! What MuJoCo is, mental model, first simulation
tutorial/quickstart.ipynb Zero-install quickstart (Colab-ready)
tutorial/01_basics.ipynb MjModel, MjData, named access
tutorial/02_rendering.ipynb Rendering, cameras, scenes
tutorial/03_simulation.ipynb Time stepping, mj_step, mj_forward
tutorial/04_control.ipynb Actuators, PD control, callbacks
tutorial/05_contact.ipynb Collision, contacts, force sensing
tutorial/06_xml_modeling.ipynb MJCF modeling guide
tutorial/07_mjx.ipynb MJX: GPU-parallel simulation with JAX
tutorial/08_gymnasium.ipynb MuJoCo + Gymnasium for RL
tutorial/09_sensors_and_estimation.ipynb Sensors, IMU, noise, state estimation
tutorial/10_troubleshooting.ipynb Common errors & how to fix them
tutorial/interactive_control.ipynb 🎮 Interactive PD tuning with sliders

Key Concepts

Concept Description
MJCF MuJoCo's XML format for defining models (docs)
MjModel Compiled model (static) — physics parameters, geometry
MjData Simulation state (dynamic) — positions, velocities, forces
mujoco.viewer Built-in interactive 3D viewer
mujoco.Renderer Offscreen rendering for headless environments
MJX JAX backend for GPU-parallel simulation (docs)

Resources


What's Next? 🚀

Once you've completed these tutorials, explore:

Resource What you'll learn
MuJoCo Menagerie Production-quality robot models (Franka, UR5e, Unitree, etc.)
dm_control DeepMind's control suite — benchmarks for continuous control
Gymnasium Leaderboard Standard RL benchmarks (HalfCheetah, Humanoid, Ant)
Brax Differentiable physics in JAX (alternative to MJX)
MuJoCo XLA (MJX) Paper Technical details of GPU-parallel MuJoCo
Robosuite Manipulation benchmarks built on MuJoCo
IsaacLab NVIDIA's sim framework (comparison point)

Contributing 🤝

  1. Fork this repository
  2. Create a new example in examples/ with inline MJCF or an XML in xml/
  3. Submit a pull request

See CONTRIBUTING.md for details.


License 📃

MIT — free to use without restrictions.

관련 프로젝트 살펴보기

불러오는 중…