Skip to main content

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.
  • Works with coding assistants — a bundled skill and MCP server let Claude Code, Codex, Gemini CLI, Antigravity and Cursor write SRMP code and run plans for you.

Installation

pip install srmp

Prebuilt wheels for Python 3.9–3.14:

Platform Requirement
Linux x86-64 (manylinux) CPU with AVX2 (Intel Haswell 2013+ / AMD Zen+) — the VAMP backend is compiled for x86-64-v3. import srmp checks for it and raises a clear ImportError otherwise.
macOS Apple Silicon macOS 11+, from 0.2.1 (0.2.0 had none). VAMP plugins are Linux-only, so on macOS only the robots built into srmp can use the VAMP backend.
Windows 10/11 No native build: install the Linux package under WSL2 with Ubuntu 22.04+ (instructions).

Full installation guide: Installation. For other platforms or older CPUs, ask on Discord.

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, 1.0, 0.0, 0.0])  # [w, x, y, z]: gripper pointing down
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 matching the registry's panda and ridgeback_ur10e (its built-in ur5 and fetch modules describe other robot models than the registry's, so those plan on coal); other robots plan on coal unless a VAMP plugin is installed for them (below). validity_backend: "auto" selects per robot, "vamp" insists and raises if unavailable.

VAMP robot plugins (srmp vamp)

A plugin adds a robot to the VAMP backend without rebuilding srmp (Linux x86-64). By default every plugin is agreement-tested against coal before it is installed; that test checks the plugin's integrity, not that its spheres cover the robot.

  • Registry robots with a published plugin (kinova_gen3_robotiq_2f85 is the first): add_robot("kinova_gen3_robotiq_2f85") fetches it, checks it against the registry robot and agreement-tests it before first use (one line on stderr; up to a few minutes, once). Nothing published, or offline: coal, silently; adding a robot never starts a build. Overriding the SRDF, end effector, joint or link names skips the lookup.
  • srmp vamp fetch <robot> does the same on request; --no-verify installs without the checks (recorded, and list says so).
  • srmp vamp add-robot --name <robot> --urdf <spherized.urdf> --end-effector <link> [--srdf <file>] [--mesh-robot <registry name or mesh URDF>] builds your own: cricket and the compiler run in Docker images pulled from Docker Hub (asked first; --build-images builds them locally instead), else on a native toolchain. --from-module <robot.hh> --spherized-urdf ... --spherized-srdf ... --end-effector ... starts from an existing cricket module.
  • srmp vamp list [--json] shows each plugin, whether it loads and what was checked; srmp vamp remove <robot> deletes one.
  • After an srmp upgrade that changes the plugin ABI tag, import srmp warns and skips the affected plugins; srmp vamp rebuild-all rebuilds them from their cached modules (--all rebuilds every plugin), and SRMP_VAMP_AUTO_REBUILD=1 does it at import. Registry prebuilts are fetched again for the new tag instead.

Plugins live in ~/.cache/srmp/vamp_plugins/ ($SRMP_VAMP_PLUGIN_PATH adds directories; its first entry becomes the install directory). Details: VAMP plugins.

Planners

Single robot: Astar, wAstar, ARAstar, MHAstar, wPASE (parallel), MGS (multi-graph search), vamp_rrtc. Multi-robot: ECBS, xECBS. Which to use: Choosing a planner. Every setting: Planner settings. Motion-primitive files: Motion primitives.

Visualization and agent

  • Viser and MeshCat visualizers: srmp.ViserPlannerInterface, srmp.VisualPlannerInterface — drop-in replacements for PlannerInterface with an interactive goal gizmo and plan panel.
  • Agent 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). See Agent Mode.
  • Scenes and plans round-trip through save_scene / load_scene / save_plan / load_plan — see Saving and loading.

Using SRMP with coding assistants

SRMP bundles a skill (instructions and verified code samples) and an MCP server (srmp mcp, a persistent planning session) for Claude Code, Codex, Gemini CLI, Antigravity and Cursor:

pip install "srmp[mcp]"            # the MCP server needs Python 3.10+
srmp skill install --for <tool>    # <tool>: claude, codex, gemini, antigravity, cursor, all
srmp mcp install --for <tool>      # prints the command/config to register the server

srmp skill install installs into the project by default (--user for your home directory); re-run it after upgrading SRMP. srmp mcp install never edits your config: it prints what to paste or run.

Claude Code users can instead install both as a plugin (still after pip install "srmp[mcp]", since the plugin's MCP server runs srmp):

/plugin marketplace add imishani/srmp-assistant
/plugin install srmp@srmp

The MCP tools are run_srmp_code, describe_scene, start_visualizer and reset_session. The 3D viewer binds to 127.0.0.1 only; forward the port (ssh -L) to view it from another machine. Full guide: Coding Assistants.

License

AGPL-3.0-or-later. See the GNU AGPL v3.

Metadata

Release files for srmp 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for srmp 0.2.2
File Actions
srmp-0.2.2-cp314-cp314-manylinux_2_35_x86_64.whl CPython 3.14 CPython 3.14 Linux glibc 2.35+ x86-64 Details for srmp-0.2.2-cp314-cp314-manylinux_2_35_x86_64.whl
srmp-0.2.2-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details for srmp-0.2.2-cp314-cp314-macosx_11_0_arm64.whl
srmp-0.2.2-cp313-cp313-manylinux_2_35_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.35+ x86-64 Details for srmp-0.2.2-cp313-cp313-manylinux_2_35_x86_64.whl
srmp-0.2.2-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details for srmp-0.2.2-cp313-cp313-macosx_11_0_arm64.whl
srmp-0.2.2-cp312-cp312-manylinux_2_35_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.35+ x86-64 Details for srmp-0.2.2-cp312-cp312-manylinux_2_35_x86_64.whl
srmp-0.2.2-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for srmp-0.2.2-cp312-cp312-macosx_11_0_arm64.whl
srmp-0.2.2-cp311-cp311-manylinux_2_35_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.35+ x86-64 Details for srmp-0.2.2-cp311-cp311-manylinux_2_35_x86_64.whl
srmp-0.2.2-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details for srmp-0.2.2-cp311-cp311-macosx_11_0_arm64.whl
srmp-0.2.2-cp310-cp310-manylinux_2_35_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.35+ x86-64 Details for srmp-0.2.2-cp310-cp310-manylinux_2_35_x86_64.whl
srmp-0.2.2-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details for srmp-0.2.2-cp310-cp310-macosx_11_0_arm64.whl
srmp-0.2.2-cp39-cp39-manylinux_2_35_x86_64.whl CPython 3.9 CPython 3.9 Linux glibc 2.35+ x86-64 Details for srmp-0.2.2-cp39-cp39-manylinux_2_35_x86_64.whl
srmp-0.2.2-cp39-cp39-macosx_11_0_arm64.whl CPython 3.9 CPython 3.9 macOS 11.0+ ARM64 Details for srmp-0.2.2-cp39-cp39-macosx_11_0_arm64.whl

Total release size: 155.7 MB

Release files / srmp-0.2.2-cp314-cp314-manylinux_2_35_x86_64.whl

Download URL srmp-0.2.2-cp314-cp314-manylinux_2_35_x86_64.whl
Size 13.3 MB
Tags CPython 3.14 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
f534b857029c3e7d3f0d6af04b329102c3b9f82037915ebed665b10dc15e89f7
BLAKE2b-256 checksum
How to use checksums
c46b03ebc8c1cbba49558a08c8c5336af389b368d68835d5035d82f1eef44246
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp314-cp314-macosx_11_0_arm64.whl

Download URL srmp-0.2.2-cp314-cp314-macosx_11_0_arm64.whl
Size 12.8 MB
Tags CPython 3.14 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
cbfd3b7448a2bc04bdd0c29dd6cb1c2ee4f10c7325d23bda9207caf399d26bd8
BLAKE2b-256 checksum
How to use checksums
ca028774585da433be62e6787dc665626bd9d97fb9b9bc94d50ba5a7533e54f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp313-cp313-manylinux_2_35_x86_64.whl

Download URL srmp-0.2.2-cp313-cp313-manylinux_2_35_x86_64.whl
Size 13.3 MB
Tags CPython 3.13 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
2d3d1f102aae06ae93dd120b7719408426c1f5e865e7abf6cc61f76e4fb3b727
BLAKE2b-256 checksum
How to use checksums
120f053f4ea72bfde125b74da6afd67692e080f1b198be17c8725222cf714dbf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp313-cp313-macosx_11_0_arm64.whl

Download URL srmp-0.2.2-cp313-cp313-macosx_11_0_arm64.whl
Size 12.8 MB
Tags CPython 3.13 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
28ec221ccc0a523e24e054ce1d361fc6823df9d422c0a3acd1e0a51797532195
BLAKE2b-256 checksum
How to use checksums
e4bae4e4fa18ab56c91582b8a5e2378986215aa2360fa7a5d33467701f4ae252
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp312-cp312-manylinux_2_35_x86_64.whl

Download URL srmp-0.2.2-cp312-cp312-manylinux_2_35_x86_64.whl
Size 13.3 MB
Tags CPython 3.12 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
2e2803e33b3aa115c45771c6a32a9cab6aa7ead87fd334e455bb8e7973a8ddb4
BLAKE2b-256 checksum
How to use checksums
2207c9c34acd7bdf9d774373c0bf3cdc37f68f42ed931a1964acebc76eca8099
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp312-cp312-macosx_11_0_arm64.whl

Download URL srmp-0.2.2-cp312-cp312-macosx_11_0_arm64.whl
Size 12.8 MB
Tags CPython 3.12 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
a59bd1b349b7d3f0ce6beac30c1b34fd5dfbfdc4637eaa2ce557eba6197b089b
BLAKE2b-256 checksum
How to use checksums
2a1f937dd28a14754921d9ee5043237ca7cd241a215c205d865f65af062928ae
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp311-cp311-manylinux_2_35_x86_64.whl

Download URL srmp-0.2.2-cp311-cp311-manylinux_2_35_x86_64.whl
Size 13.3 MB
Tags CPython 3.11 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
1338b37d60a7c93cdd346927fd2013c425b0f2462378fc903283d119feb29fa5
BLAKE2b-256 checksum
How to use checksums
caea79abda82d9181a26f422a08bd4d678d306eb014bf3d7ede24ff1de5087ec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp311-cp311-macosx_11_0_arm64.whl

Download URL srmp-0.2.2-cp311-cp311-macosx_11_0_arm64.whl
Size 12.8 MB
Tags CPython 3.11 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
4aaad01d215ba889a5c84d0f3379d807e7352520e685abb39a5a9801dedca505
BLAKE2b-256 checksum
How to use checksums
e6d9c590b47dca773cb538998d4c38059c867bde49232935862c0349241762c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp310-cp310-manylinux_2_35_x86_64.whl

Download URL srmp-0.2.2-cp310-cp310-manylinux_2_35_x86_64.whl
Size 13.3 MB
Tags CPython 3.10 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
d72d0dcadd6ef04a674b6beee0c8526f2e5bf7a76a06a4472350c81930065bba
BLAKE2b-256 checksum
How to use checksums
621a6486cc967db96a0729ef21268daa630b97b715c391772ae661e5990a89f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp310-cp310-macosx_11_0_arm64.whl

Download URL srmp-0.2.2-cp310-cp310-macosx_11_0_arm64.whl
Size 12.8 MB
Tags CPython 3.10 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
5607185b5d480be1a5b4fd50885c023482762cde511581f5edbbeb4217d2f77d
BLAKE2b-256 checksum
How to use checksums
f7cd7f25dfbf84d649f9b7aa7fb66ed6da29c49a0cf5d19596d90c9e2cdbf1e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp39-cp39-manylinux_2_35_x86_64.whl

Download URL srmp-0.2.2-cp39-cp39-manylinux_2_35_x86_64.whl
Size 13.3 MB
Tags CPython 3.9 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
8cf1e00ecd04ac0d7ed8b85d2695924a367c720073a1216ca93ecfd9c392f433
BLAKE2b-256 checksum
How to use checksums
e734dacfcd1f9bbf295e81de87b3dbb0a45fb7d79c9b408a1009ef1f089dd7fb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Release files / srmp-0.2.2-cp39-cp39-macosx_11_0_arm64.whl

Download URL srmp-0.2.2-cp39-cp39-macosx_11_0_arm64.whl
Size 12.1 MB
Tags CPython 3.9 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
bc16bb6ccb0aed03a8b325ce3a47f674faed3ce3bce9d6bfaa5deaaaa8799ab9
BLAKE2b-256 checksum
How to use checksums
45dade42080f216471699f9395dd74f440c2bb14720b2ba31b091eccb8216b12
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.12.16

Security for srmp 0.2.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.2 This release

12 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page