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_2f85is 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-verifyinstalls without the checks (recorded, andlistsays 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-imagesbuilds 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 srmpwarns and skips the affected plugins;srmp vamp rebuild-allrebuilds them from their cached modules (--allrebuilds every plugin), andSRMP_VAMP_AUTO_REBUILD=1does 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 forPlannerInterfacewith an interactive goal gizmo and plan panel. - Agent mode:
pip install "srmp[agent]", thenpython -m srmp.agent.cliorpython -m srmp.agent.guito 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.
Links
- Documentation: https://srmp.readthedocs.io
- Release notes
- Questions and community: Discord
- Claude Code plugin: https://github.com/imishani/srmp-assistant
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)
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.