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.

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_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: 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 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.

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)

Table of built distributions (wheels) for srmp 0.2.1
File Actions
srmp-0.2.1-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.1-cp314-cp314-manylinux_2_35_x86_64.whl
srmp-0.2.1-cp314-cp314-macosx_11_0_arm64.whl CPython 3.14 CPython 3.14 macOS 11.0+ ARM64 Details for srmp-0.2.1-cp314-cp314-macosx_11_0_arm64.whl
srmp-0.2.1-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.1-cp313-cp313-manylinux_2_35_x86_64.whl
srmp-0.2.1-cp313-cp313-macosx_11_0_arm64.whl CPython 3.13 CPython 3.13 macOS 11.0+ ARM64 Details for srmp-0.2.1-cp313-cp313-macosx_11_0_arm64.whl
srmp-0.2.1-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.1-cp312-cp312-manylinux_2_35_x86_64.whl
srmp-0.2.1-cp312-cp312-macosx_11_0_arm64.whl CPython 3.12 CPython 3.12 macOS 11.0+ ARM64 Details for srmp-0.2.1-cp312-cp312-macosx_11_0_arm64.whl
srmp-0.2.1-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.1-cp311-cp311-manylinux_2_35_x86_64.whl
srmp-0.2.1-cp311-cp311-macosx_11_0_arm64.whl CPython 3.11 CPython 3.11 macOS 11.0+ ARM64 Details for srmp-0.2.1-cp311-cp311-macosx_11_0_arm64.whl
srmp-0.2.1-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.1-cp310-cp310-manylinux_2_35_x86_64.whl
srmp-0.2.1-cp310-cp310-macosx_11_0_arm64.whl CPython 3.10 CPython 3.10 macOS 11.0+ ARM64 Details for srmp-0.2.1-cp310-cp310-macosx_11_0_arm64.whl
srmp-0.2.1-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.1-cp39-cp39-manylinux_2_35_x86_64.whl
srmp-0.2.1-cp39-cp39-macosx_11_0_arm64.whl CPython 3.9 CPython 3.9 macOS 11.0+ ARM64 Details for srmp-0.2.1-cp39-cp39-macosx_11_0_arm64.whl

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.

Release history Release notifications | RSS feed

This release

0.2.1 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