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:
| 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+. 0.2.0 has no macOS wheels: pip install srmp installs 0.1.6 there until an Apple Silicon CI runner exists (#15). |
| Windows 10/11 | No native build: install the Linux package under WSL2 with Ubuntu 22.04+ (instructions). |
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 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: instructions.md.
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 forPlannerInterfacewith an interactive goal gizmo and plan panel. - Agentic mode:
pip install "srmp[agent]", thenpython -m srmp.agent.cliorpython -m srmp.agent.guito 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.
Metadata
Release files for srmp 0.2.1
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.0 MB
Release files / srmp-0.2.1-cp314-cp314-manylinux_2_35_x86_64.whl
| Download URL | srmp-0.2.1-cp314-cp314-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.14 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
c9432c1c441525ea8c3c06fe7e5ff7eddd7b38399c17de1e3aa5709268f74a05
|
|
BLAKE2b-256 checksum How to use checksums |
42537d59bdce5fedecbdf4db7dd73e97bbc75bb420704b2e60a2f296879f2328
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / srmp-0.2.1-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | srmp-0.2.1-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.7 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
be56ed938c1bb619d7983d235c3317d932fd6b58deea42ff1c876be91f151aac
|
|
BLAKE2b-256 checksum How to use checksums |
4e69b1777f8d2f83749bfdf925eb5d91f4f861b1d2021042347ac6a8d81f5da0
|
| 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.1-cp313-cp313-manylinux_2_35_x86_64.whl
| Download URL | srmp-0.2.1-cp313-cp313-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.13 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
d689ea21c7de87fc16614dd4d040fbed6f7575ba19b52b0b16db174deed94566
|
|
BLAKE2b-256 checksum How to use checksums |
a6f7770dcaf036bcdf411ee65da90832524d2075fd3335c37ab58d6821291d55
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / srmp-0.2.1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | srmp-0.2.1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.7 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
8eecbcb94be342d4e641b95cb62e95b514f5c7db35985c4fd5483e5297a3a852
|
|
BLAKE2b-256 checksum How to use checksums |
551e86b387590364f6030ad7e7fb9d1d80106d53c82aa19e77c3f8fad25ecddd
|
| 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.1-cp312-cp312-manylinux_2_35_x86_64.whl
| Download URL | srmp-0.2.1-cp312-cp312-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.12 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
f0d3ffaf972b129a22dd426bb7246a6f05fdf27f96fa605782c9c4dfe7ed608d
|
|
BLAKE2b-256 checksum How to use checksums |
20760406a7f6a5c10154e1bd3b6789c7dd53135f1eb542dc974ee4ca30cc31bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / srmp-0.2.1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | srmp-0.2.1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.7 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a8774fc102aefca928cd26befa6d469da926b27e4191b361c487e6573de4f19c
|
|
BLAKE2b-256 checksum How to use checksums |
b222c7b52013ba377a4d91535556f5c30f6867a5d9eb007947e8f33539e14244
|
| 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.1-cp311-cp311-manylinux_2_35_x86_64.whl
| Download URL | srmp-0.2.1-cp311-cp311-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.11 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
3228ac9fe6ccf6c4990328e00a6b67c34ed32028d7426b20898f97b40bcae21b
|
|
BLAKE2b-256 checksum How to use checksums |
e6622ce3a7b34b0e0a77fe28e43fd14819e1c7f26bfa9145ce3a1f191b67149c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / srmp-0.2.1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | srmp-0.2.1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.7 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7a80f442b57d7284d2aa09e2b84c81316866e344627a25bc981f3ce9ad9bee77
|
|
BLAKE2b-256 checksum How to use checksums |
2caf9b3e1d0e3879a451b722120ed57342ea419ea08b6e68e70f6deff41e8262
|
| 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.1-cp310-cp310-manylinux_2_35_x86_64.whl
| Download URL | srmp-0.2.1-cp310-cp310-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.10 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
fefcbc89b84f138e202be1b5df0b18e57a6f4d8de9abd71b082d1036267c9131
|
|
BLAKE2b-256 checksum How to use checksums |
e87cfbb96c7ef06a3c8c3961eb77ea95a215640a49a363d621922d28ebb94851
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / srmp-0.2.1-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | srmp-0.2.1-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 12.7 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
4ac06781664229e5277668e3e5b45d5114b4707d2915fb8171b956b9c7617d5a
|
|
BLAKE2b-256 checksum How to use checksums |
1f027ccbf1c1ddf28e94fcc04b6542aebcef0982b0b936dd3c45496ab16fb271
|
| 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.1-cp39-cp39-manylinux_2_35_x86_64.whl
| Download URL | srmp-0.2.1-cp39-cp39-manylinux_2_35_x86_64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.9 Linux glibc 2.35+ x86-64 |
|
SHA-256 checksum How to use checksums |
9b4d6fab8129e57309d11402a71db336f38191cc729eca57d98908105e59d039
|
|
BLAKE2b-256 checksum How to use checksums |
a47c142da01175f141ec4b023d3dd4cd1e4ec9dd6c7b5360382f8c06c91a63f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / srmp-0.2.1-cp39-cp39-macosx_11_0_arm64.whl
| Download URL | srmp-0.2.1-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 |
daee3fa03a354aeebd021b3f813437c89bc9022712ee5f226d4b0bc45f473a50
|
|
BLAKE2b-256 checksum How to use checksums |
338e2726b97672020f247dd47591fe6779b8f7695e20abfa70d843d47b330127
|
| 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.1
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.