Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Tesseract Python (nanobind)

A rail-mounted robot places a car seat through a car's door opening. Click to play the demo in your browser.

PyPI Python Wheels Documentation license - Apache 2.0

Python bindings for Tesseract, the ROS-Industrial motion planning framework. Load a robot, check collisions, solve kinematics and plan collision-free trajectories from Python, without ROS.

The bindings cover the Tesseract C++ libraries module by module:

  • environment and scene graph,
  • kinematics (KDL, OPW, UR), collision checking (Bullet, FCL)
  • OMPL motion-planning, TrajOpt-Ifopt, Descartes and simple planners.
  • time parameterization (TOTG, ISP, constant TCP speed, Ruckig) and the task composer

A Python layer adds a planning API, constraints written in Python for the online SQP solver (trajopt_ifopt.python_constraints) A browser viewer and controller program emitters (ABB RAPID, KUKA KRL, Fanuc TP, Yaskawa INFORM, Universal Robots URScript).

Over 4,300 tests run against every wheel CI builds.

Installation

pip install --pre "tesseract-robotics-nanobind[support]"

--pre selects the current release candidate, 0.36.0.0rc1; drop it once 0.36.0.0 is final. The [support] extra adds tesseract's example robots and meshes (tesseract-robotics-nanobind-support), which the examples and the Quick Start load. Leave it out if you only use your own robots.

One cp312-abi3 wheel per platform covers Python 3.12 to 3.15:

  • Linux: x86_64 and aarch64, manylinux_2_39 (Ubuntu 24.04+, Debian 13+)
  • macOS: arm64 and x86_64, macOS 15.0 or later
  • Windows: x86_64

Examples

Recorded examples play in the browser, inline on the documentation pages. Orbit, scrub and change speed without installing anything.

The source is in src/tesseract_robotics/examples. Each example installs as a console script, such as tesseract_car_seat_example.

Quick Start

Plan a motion for the ABB IRB 2400 and play it in the browser:

from tesseract_robotics import get_tesseract_resource_path
from tesseract_robotics.common import GeneralResourceLocator
from tesseract_robotics.planning import (
    CartesianTarget, JointTarget, MotionProgram, Pose, Robot, plan_freespace,
)
from tesseract_robotics.viewer import TesseractViewer

locator = GeneralResourceLocator(paths=[get_tesseract_resource_path()])
robot = Robot.from_tesseract_support("abb_irb2400", locator)

# All-zero joints (rad) to a tool-down pose of tool0 in base_link: metres, [qx, qy, qz, qw]
program = (
    MotionProgram("manipulator", tcp_frame="tool0", working_frame="base_link")
    .move_to(JointTarget([0.0] * 6))
    .move_to(CartesianTarget(Pose.from_xyz_quat(0.8, -0.2, 0.8, 0.0, -1.0, 0.0, 0.0)))
)
result = plan_freespace(robot, program)
assert result.successful, result.message

with TesseractViewer() as viewer:
    viewer.update_environment(robot.env)
    viewer.update_trajectory(result.raw_results)
    input(f"{len(result.trajectory)} states, {result.trajectory[-1].time:.2f} s: open {viewer.url}, Enter quits")

plan_freespace runs the TrajOptPipeline: TrajOpt, a discrete collision check of every state, and time parameterization. The quickstart goes on to kinematics, collision checks and the other planners.

Documentation

The documentation has the concepts, user guide, API reference and breaking changes; its sources are in docs/.

Versioning

Version follows 0.A.B.C: A.B is the Tesseract series the bindings wrap and C is the nanobind patch number; a pre-release appends rcN. Releases up to 0.35.0.x wrap a tagged Tesseract release. The 0.36 series builds tesseract, trajopt and tesseract_planning from upstream master plus the open upstream pull requests we carry (tesseract_robotics.build_identity.UPSTREAM_SOURCES lists the exact commits), until the 0.36 tags exist upstream.

See CHANGELOG.md for release notes.

Development

Setup, tasks, tests and wheel builds are in the developer guide.

Acknowledgments

This project builds upon the excellent work of John Wason and the Tesseract Robotics team. The original tesseract_python SWIG bindings laid the foundation for this nanobind implementation.

License

Apache 2.0. Attribution notices are in NOTICE.

Metadata

Release files for tesseract-robotics-nanobind 0.36.0.0rc1

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 tesseract-robotics-nanobind 0.36.0.0rc1
File Actions
tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-win_amd64.whl
tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_x86_64.whl CPython 3.12 abi3 Linux glibc 2.39+ x86-64 Details for tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_x86_64.whl
tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_aarch64.whl CPython 3.12 abi3 Linux glibc 2.39+ ARM64 Details for tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_aarch64.whl
tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_x86_64.whl CPython 3.12 abi3 macOS 15.0+ x86-64 Details for tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_x86_64.whl
tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_arm64.whl CPython 3.12 abi3 macOS 15.0+ ARM64 Details for tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_arm64.whl

Total release size: 120.4 MB

Release files / tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-win_amd64.whl

Download URL tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-win_amd64.whl
Size 20.8 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
5fee2c5086bfacf26176ce7270d4352b8e535d50a756f68df1756cf03cafb921
BLAKE2b-256 checksum
How to use checksums
f564ffb62d2fbbd9d07524eb80555f4e5c37e1c95b43e47ffe78bbc8068d4b1b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_x86_64.whl

Download URL tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_x86_64.whl
Size 29.7 MB
Tags CPython 3.12 Linux glibc 2.39+ x86-64 abi3
SHA-256 checksum
How to use checksums
f5d446f42d3c118444b750e1bf703a1e5ca376f915f2106bb70cf3b4574f0165
BLAKE2b-256 checksum
How to use checksums
ce655e7e7a48e3750098ecf97cb32dbb58ea6a7ce90fc7a075be10a21ba98937
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_aarch64.whl

Download URL tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-manylinux_2_39_aarch64.whl
Size 28.2 MB
Tags CPython 3.12 Linux glibc 2.39+ ARM64 abi3
SHA-256 checksum
How to use checksums
f6c8ed7b4cbfff66e9f8c1421d5db7640ce7e66df9bc1a3cd8ddc26591531142
BLAKE2b-256 checksum
How to use checksums
f0eeaa663dd652e8326baf506d7a0cd9e900a5f9072c52b7c9db0789682adb39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_x86_64.whl

Download URL tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_x86_64.whl
Size 22.4 MB
Tags CPython 3.12 abi3 macOS 15.0+ x86-64
SHA-256 checksum
How to use checksums
132edf27c2eadc9db84241b2008c086b90f046d699c9824b53086cd9eebae446
BLAKE2b-256 checksum
How to use checksums
f6d455ef09112c1f99136699a74f864da092b3b7070e4d40b2a27b707228e76f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_arm64.whl

Download URL tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-macosx_15_0_arm64.whl
Size 19.2 MB
Tags CPython 3.12 abi3 macOS 15.0+ ARM64
SHA-256 checksum
How to use checksums
beff0efe90054991d0305d4da90f13b2c678228fa9d127ef72abc7f00f5d0e01
BLAKE2b-256 checksum
How to use checksums
b0e3afce9ab3b4b48c301debf84881b45a3ee93e67a0149d77021d8da4c4ff58
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for tesseract-robotics-nanobind 0.36.0.0rc1

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.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for tesseract_robotics_nanobind-0.36.0.0rc1-cp312-abi3-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

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.

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