Skip to main content
EmbodiK logo

EmbodiK

Python C++ Nanobind Build PyPI Docs License: Apache-2.0 GitHub stars

EmbodiK is a high-performance prioritized numerical inverse kinematics library for cross-embodiment robotics and VLA/AI applications. It pairs a C++ core with Python bindings, exposes robot-model utilities without requiring the Python pin package at runtime, and includes interactive examples for collision-aware IK, CoM constraints, teleop, whole-body robots, GPU batch solving, and dual-arm coordination.

✨ Overview

EmbodiK is designed for bringing up IK behavior across different robot bodies without rewriting the solver stack for each model. The public examples focus on a practical path:

  • 🧭 start with the smallest fixed-base IK loop.
  • 🛡️ add collision, joint-limit, and CoM constraints.
  • 🎮 connect the same prioritized IK solver path to teleop input.
  • 🤖 scale to bimanual, humanoid, and Spot whole-body examples.
  • 🧪 use richer clone-only examples for development, stress testing, and policy rollout.

The intent is to keep Python examples lean: visualization and target plumbing stay in Python, while constraint handling and recovery policy stay in the C++ solver.

The detailed installation notes, API reference, and example walkthroughs live in the official documentation:

https://robodreamer.github.io/embodik/

🚀 Quick Start

Fastest path for most users is the wheel-only PyPI install inside a virtual environment:

python -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
python -m pip install --only-binary=:all: embodik
python -c "import embodik; print(embodik.__version__)"

If that import works, the core package is installed. Copy the examples and run the fixed-base loop:

python -m pip install "embodik[examples]"
embodik-examples --copy
cd embodik_examples
python 01_basic_ik_simple.py

If pip cannot find a compatible wheel, use the one-shot source installer for your platform from the Installation Guide. It creates the venv, installs native dependencies, builds EmbodiK, and runs an import smoke test.

Published repaired wheels do not require the Python pin package at runtime. Source builds use pin or a system Pinocchio install as the native library provider; keep that provider installed in the environment used to import EmbodiK.

⚡ Experimental GPU whole-body IK

The animation is the default 512-world viewer. The measured reference scale is 1,024 worlds (--worlds 1024), which is a separate run from this preview.

Panda, ROBOTIS AI Worker, and Unitree G1 moving through distinct trajectories across 512 fully articulated CUDA worlds

embodik.gpu.wbc is experimental and opt-in. The CPU solver remains the stable default. The GPU path derives joint and task dimensions from the loaded model, including Panda, AI Worker, and G1. There is no silent CPU fallback.

From a source checkout:

pixi run setup-gpu-wbc
pixi run -e cuda demo-parallel-tracking

The viewer opens at http://localhost:8080. Device memory, model switches, the 1,024-world latency table, and how those samples were measured are in the GPU WBC guide. The parallel example guide covers headless profiling and RL integration.

🎮 Examples

01_basic_ik_simple.py is the minimal fixed-base bring-up for a robot preset or a new URDF. Most scripts default to the Panda preset. Collision, teleop, CoM, dual-arm coordination, bimanual and humanoid whole-body control, Spot, and the GPU batch demo are listed in the Examples Guide, including Seer controller ports and the mjviser policy flags.

🎬 Preview

Franka Panda collision-free IK

Franka Panda collision-free IK preview

ROBOTIS AI Worker constraint teleop

ROBOTIS AI Worker constraint teleop preview

RB-Y1 bimanual whole-body IK

RB-Y1 bimanual whole-body IK preview

Unitree G1 retargeting IK

Unitree G1 retargeting IK preview

Spot full-body IK

Spot full-body IK preview

Spot locomanipulation mjviser

Spot locomanipulation mjviser preview

🧰 Core Capabilities

  • ⚙️ C++ IK core with Nanobind Python bindings.
  • 🎯 Hierarchical velocity IK tasks for frames, posture, CoM, and dual-arm coordination.
  • 🧮 Fixed-base acceleration eSNS with compatible position, velocity, acceleration, effort, contact-kinematics, and geometry constraints.
  • 🛡️ Joint-limit, self-collision, and CoM support-polygon constraints.
  • 📈 Solver diagnostics for timing, task scaling, and Jacobian condition-number logging.
  • 🧭 Lie-group-aware configuration operations for floating-base, quaternion, and continuous joints.
  • 🤖 Native Pinocchio-backed robot model utilities exposed through EmbodiK bindings.
  • 👁️ Optional Viser visualization for interactive IK demos.
  • ⚡ Model-derived Newton/Warp GPU WBC with device-resident multi-world state, CUDA graph execution, collision constraints, task priority, posture, torso, and centroidal features.

📚 Documentation

  • Installation - platform setup, source builds, and troubleshooting.
  • Quickstart - first IK calls and solver concepts.
  • Acceleration Solver - fixed-base scope, state-box semantics, and collision certification boundaries.
  • Working with Transforms - transform helpers and SE(3) operations.
  • Examples - public scripts and development-only demos.
  • API Reference - Python API generated from docstrings.
  • GPU WBC - Newton/Warp setup, model compatibility, constraint coverage, batching, and performance methodology.
  • Development - local build, tests, and contributor workflow.

🛠️ Development

Use Pixi from a repository clone:

pixi run build
pixi run test
pixi run docs-build

Run examples from the clone:

pixi run python examples/01_basic_ik_simple.py
pixi run python examples/02_collision_aware_IK.py
pixi run python examples/03_teleop_ik.py

🗂️ Repository Layout

embodik/
|-- README.md
|-- cpp_core/
|   |-- include/embodik/
|   `-- src/
|-- python_bindings/
|   `-- src/
|-- python/embodik/
|-- examples/
|-- docs/
|-- scripts/
`-- test/

⭐ Star History

Star History Chart

📄 License

EmbodiK is released under the Apache License 2.0. See LICENSE for details. Binary wheels may bundle permissively licensed native dependencies; see THIRD_PARTY_NOTICES.md. Cite the project with CITATION.cff.

Developer: Andy Park andypark.purdue@gmail.com

Metadata

Release files for embodik 0.23.3

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

Source distribution (sdist)

Source distribution for embodik 0.23.3
File Size Uploaded Provenance Actions
embodik-0.23.3.tar.gz 37.7 MB With provenance Details for embodik-0.23.3.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for embodik 0.23.3
File Actions
embodik-0.23.3-cp312-cp312-manylinux_2_28_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.28+ x86-64 Details for embodik-0.23.3-cp312-cp312-manylinux_2_28_x86_64.whl
embodik-0.23.3-cp312-cp312-macosx_14_0_arm64.whl CPython 3.12 CPython 3.12 macOS 14.0+ ARM64 Details for embodik-0.23.3-cp312-cp312-macosx_14_0_arm64.whl
embodik-0.23.3-cp311-cp311-manylinux_2_28_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.28+ x86-64 Details for embodik-0.23.3-cp311-cp311-manylinux_2_28_x86_64.whl
embodik-0.23.3-cp311-cp311-macosx_14_0_arm64.whl CPython 3.11 CPython 3.11 macOS 14.0+ ARM64 Details for embodik-0.23.3-cp311-cp311-macosx_14_0_arm64.whl
embodik-0.23.3-cp310-cp310-manylinux_2_28_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.28+ x86-64 Details for embodik-0.23.3-cp310-cp310-manylinux_2_28_x86_64.whl
embodik-0.23.3-cp310-cp310-macosx_14_0_arm64.whl CPython 3.10 CPython 3.10 macOS 14.0+ ARM64 Details for embodik-0.23.3-cp310-cp310-macosx_14_0_arm64.whl

Total release size: 263.0 MB

Release files / embodik-0.23.3.tar.gz

Download URL embodik-0.23.3.tar.gz
Size 37.7 MB
Tags Source
SHA-256 checksum
How to use checksums
1e627b20142770109b15e130ef409b44b61f9206ed223f98f22d06256e4f1070
BLAKE2b-256 checksum
How to use checksums
c746959f811f46a4012ead30c91e0da8a158758dd28a539b17074258869e9ce2
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 18, 2026.

Transparency log

Release files / embodik-0.23.3-cp312-cp312-manylinux_2_28_x86_64.whl

Download URL embodik-0.23.3-cp312-cp312-manylinux_2_28_x86_64.whl
Size 29.5 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
b0838804bb9972d16eacd1a47a05bbd1e0c7698f2998e1837e37bca487c251ef
BLAKE2b-256 checksum
How to use checksums
be92bf3e4eed5a3f92271cbd29033b89eb85630cf3cd81c28877dd4343267180
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 18, 2026.

Transparency log

Release files / embodik-0.23.3-cp312-cp312-macosx_14_0_arm64.whl

Download URL embodik-0.23.3-cp312-cp312-macosx_14_0_arm64.whl
Size 45.6 MB
Tags CPython 3.12 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
7853d606dcc44138778ded6387bd53b5b1310789048ffb959ffdaa1659c6db4b
BLAKE2b-256 checksum
How to use checksums
d0fd8e31278fd49de457c5969f5b81e53e427c73da0d6c4ceb8c1e614621ce07
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 18, 2026.

Transparency log

Release files / embodik-0.23.3-cp311-cp311-manylinux_2_28_x86_64.whl

Download URL embodik-0.23.3-cp311-cp311-manylinux_2_28_x86_64.whl
Size 29.5 MB
Tags CPython 3.11 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
f954777ec058cb2fc60fb014fee62fb668d92a95df3bd839d8b9d13e6a205767
BLAKE2b-256 checksum
How to use checksums
047779864cf222f826ced31fb2787f5347f63fca06e71bc5cb674ea3f417add3
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 18, 2026.

Transparency log

Release files / embodik-0.23.3-cp311-cp311-macosx_14_0_arm64.whl

Download URL embodik-0.23.3-cp311-cp311-macosx_14_0_arm64.whl
Size 45.6 MB
Tags CPython 3.11 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
2b6de0ba8ee143cf2c8a5699d3ac75c021f892dee5874965c18f940444800137
BLAKE2b-256 checksum
How to use checksums
96ef2ae56baf768517d293009f32d9578c61fac7a04bd042f77a2c002a422a5a
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 18, 2026.

Transparency log

Release files / embodik-0.23.3-cp310-cp310-manylinux_2_28_x86_64.whl

Download URL embodik-0.23.3-cp310-cp310-manylinux_2_28_x86_64.whl
Size 29.5 MB
Tags CPython 3.10 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
92d783e60b2578e2a3cf90a31eb33abd182d30b8f425e84a43202365091c8215
BLAKE2b-256 checksum
How to use checksums
36b9fef890ac91deef870c83cc5eed33ef22487aae6fc934c28ab183cbc7632e
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 18, 2026.

Transparency log

Release files / embodik-0.23.3-cp310-cp310-macosx_14_0_arm64.whl

Download URL embodik-0.23.3-cp310-cp310-macosx_14_0_arm64.whl
Size 45.6 MB
Tags CPython 3.10 macOS 14.0+ ARM64
SHA-256 checksum
How to use checksums
79ca1f4dd1bf30c2d14d2ad496f9902b5589ca100961ae9018306062e285d9dd
BLAKE2b-256 checksum
How to use checksums
cce452d1c288fe2c9f4f2c2cabb578d18b358a5e430151a0f3147080db75d914
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 18, 2026.

Transparency log

Security for embodik 0.23.3

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 7 files in this release have been uploaded with provenance metadata.

Select from 7 files

Attestation for embodik-0.23.3.tar.gz

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 18, 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.

Release history Release notifications | RSS feed

This release

0.23.3 This release

7 release files Full 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