embodik 0.20.7

High-performance inverse kinematics solver optimized for cross-embodiment VLA/AI applications

EmbodiK

EmbodiK is a high-performance 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, 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-aware behavior and visualization.
• connect the same stepping IK pattern to teleop input.
• use richer clone-only examples for development and stress testing.

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

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

Quick Start

Install from PyPI:

python -m pip install --only-binary=:all: embodik
python -c "import embodik; print(embodik.__version__)"

If that import works, the core package is installed.

If pip cannot find a compatible wheel, follow the platform-specific source-build setup in the Installation Guide.

Optional: follow the Installation Guide examples setup once, then run the basic IK demo from the copied example directory:

cd embodik_examples
python 01_basic_ik_simple.py

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.

Examples

The pip-facing examples are intentionally split by purpose:

Script	Purpose
01_basic_ik_simple.py	Minimal fixed-base IK bring-up for a robot preset or new URDF.
02_collision_aware_IK.py	Collision-aware IK behavior demo and advanced tuning surface.
03_teleop_ik.py	Small adapter showing how teleop input drives the same IK step.
08_com_constraint_example.py	CoM support-polygon constraint visualization.
09_dual_arm_ects.py	Dual-arm ECTS and orthogonal coordination modes.
12_bimanual_whole_body_ik.py	Bimanual whole-body teleop, defaulting to AI Worker and optionally supporting RB-Y1, with CoM and collision handling.
13_unitree_g1_retargeting_ik.py	Unitree G1 whole-body retargeting IK with CoM and optional collision handling.

Run them from a copied example directory:

python 02_collision_aware_IK.py
python 03_teleop_ik.py
python 12_bimanual_whole_body_ik.py
python 13_unitree_g1_retargeting_ik.py

Most examples default to the Panda preset. Use --robot <key> when a script supports alternate robot presets. See the Examples Guide for the full catalog, helper conventions, and clone-only development examples.

Preview

Franka Panda collision-free IK

ROBOTIS AI Worker constraint teleop

RB-Y1 bimanual whole-body IK

Unitree G1 retargeting IK

Core Capabilities

• C++ IK core with Nanobind Python bindings.
• Hierarchical velocity IK tasks for frames, posture, CoM, and dual-arm coordination.
• 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.
• Experimental GPU batch IK and collision tooling for high-throughput research workflows.

Documentation

• Installation - platform setup, source builds, and troubleshooting.
• Quickstart - first IK calls and solver concepts.
• Working with Transforms - transform helpers and SE(3) operations.
• Examples - public scripts and development-only demos.
• API Reference - Python API generated from docstrings.
• GPU Solvers - FI-PeSNS and PPH-SNS batch solver notes.
• 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

Clone-only advanced surfaces live under dev_examples/ and are not copied by embodik-examples --copy.

Repository Layout

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

Star History

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.

Developer: Andy Park [e-mail]