Examples
These examples cover common SuperDex Robotics workflows. Each page mirrors a
runnable script in superdex_robotics/examples/, broken into logically grouped
snippets with the explanation drawn from the script's own comments, so you can
read along and then run it.
Basic
| Example | Script | You'll learn |
|---|---|---|
| Loading a Bot | examples/basic/example_bot_loading.py | Load a .superdex_bot and simulate it with the debugger. |
| Loading a Scene | examples/basic/example_scene_loading.py | Assemble a workcell from separate bots and a task prefab. |
| Loading from URDF | examples/basic/example_urdf_loading.py | Import a robot straight from a .urdf, including the runtime loader's pitfalls. |
Control
| Example | Script | You'll learn |
|---|---|---|
| JSC Control | examples/control/example_jsc_control.py | Drive joints with a joint-space PD controller. |
| OSC Control | examples/control/example_osc_control.py | Track a Cartesian target with an operational-space PD controller. |
| IK + Pose Control | examples/control/example_ik_pose_control.py | Solve inverse kinematics and hold the result with a pose controller. |
| OSC + JSC Control | examples/control/example_osc_jsc_control.py | Combine two controllers on one arm-hand bot. |
| Bimanual Control | examples/control/example_bimanual_control.py | Run one OSC per arm on a two-armed bot. |
Running the examples
Set up uv and the SuperDex wheels as described in
Getting Started, then run any example from the
repository root:
uv run python superdex_robotics/examples/basic/example_bot_loading.py