srmp 0.1.6

SRMP is a motion planning library for robotic manipulation built on state-of-the-art search-based algorithms. It produces consistent, predictable motions backed by rigorous theoretical guarantees, and plans for up to dozens of manipulators at once while guaranteeing collision-free execution — between robots and with the environment.

Why SRMP?

Existing motion planning frameworks often struggle with the demands of high-stakes applications, where predictability and repeatability are critical. SRMP addresses these challenges with search-based planning, giving motions that are both efficient and reliable — for single-arm manipulation, industrial automation, mobile manipulators and large-scale multi-robot coordination.

Key features

• Multi-robot motion planning — first-of-its-kind support for coordinated motions in multi-manipulator systems.
• Reliable, consistent trajectories — predictable and repeatable, for high-precision and safety-critical use.
• Two collision-checking backends — coal mesh collision checking, and the VAMP SIMD backend for supported robots (sub-millisecond planning on uncluttered scenes).
• Mobile manipulators — whole-body planning for arm-on-base systems with base-aware heuristics.
• Seamless integration — works with MuJoCo, Sapien, Genesis, PyBullet and Isaac; MoveIt! plugin for deployment on real systems.
• Python and C++ — one library for research and industrial workflows.

Installation

pip install srmp

Prebuilt wheels for Python 3.9–3.14:

Other platforms, older CPUs, or building from source: see instructions.md.

Quick start

import numpy as np
import srmp

planner = srmp.PlannerInterface()
planner.add_robot("panda")               # downloaded from the robot registry on first use

# An obstacle in the scene.
box = srmp.Pose()
box.p = np.array([0.5, 0.2, 0.4])
planner.add_box("box", np.array([0.1, 0.1, 0.4]), box)

# Weighted A* with a BFS workspace heuristic; the collision backend picks
# VAMP when the robot supports it, coal otherwise.
planner.make_planner(["panda"], {
    "planner_id": "wAstar", "heuristic": "bfs", "weight": "10",
    "validity_backend": "auto",
})

start = np.radians([50, 47, -10, -35, -22, 93, 39])

goal_pose = srmp.Pose()
goal_pose.p = np.array([0.642, -0.068, 0.505])
goal_pose.q = np.array([0.0, 0.0, 0.0, 1.0])
goal = srmp.GoalConstraint(srmp.GoalType.POSE, [goal_pose])

traj = planner.plan(start, goal)
print(len(traj.positions), "waypoints, backend:", planner.get_active_validity_backend())

Joint-space goals use srmp.GoalConstraint(srmp.GoalType.JOINTS, q_goal). For several robots, make_planner([...], ctx) with more than one articulation and plan_multi(...).

Robots

Robot descriptions are downloaded on demand from the SRMP registry — panda, ur5, ur10e, fetch, kinova_gen3, xarm6, ridgeback_ur10e and others (srmp.robots.list_available()). Your own robot: srmp.robots.register("name", urdf_path=..., srdf_path=..., end_effector=...), or pass a URDF path to add_robot.

The VAMP backend ships with modules for panda, ur5, fetch and ridgeback_ur10e; every other robot plans on coal. validity_backend: "auto" selects per robot, "vamp" insists and raises if unavailable.

Planners

Single robot: Astar, wAstar, ARAstar, MHAstar, wPASE (parallel), MGS (multi-graph search), vamp_rrtc. Multi-robot: ECBS, xECBS. Parameters, mobile-manipulator setup and motion-primitive files are covered in instructions.md.

Visualization and agent

• Viser and MeshCat visualizers: srmp.ViserPlannerInterface, srmp.VisualPlannerInterface — drop-in replacements for PlannerInterface with an interactive goal gizmo and plan panel.
• Agentic mode: pip install "srmp[agent]", then python -m srmp.agent.cli or python -m srmp.agent.gui to drive the planner in natural language (Gemini by default).
• Scenes and plans round-trip through save_scene / load_scene / save_plan / load_plan — see Saving and Loading.

Links

• Documentation: https://srmp.readthedocs.io
• Source and issues: https://gitlab.com/robot_planning/open/ims_manip
• Developer guide (building, backends, planner reference): instructions.md

License

AGPL-3.0-or-later. See LICENSE.