Skip to main content

RetargetingKit

Python 3.10+ GitHub Actions

RetargetingKit maps live or recorded human motion to robot hands, arms, and humanoids using RoboKit optimization and neural hand models.

The two main applications are:

  • 🎮 Real-time teleoperation
  • ⚡ Offline retargeting in parallel

Installation

Requires Python 3.10 or newer:

uv add retargetingkit      # or: pip install retargetingkit

See Installation for source installs, extras, and asset access.

Features

Tracked hand skeleton and retargeted robot hand side by side
Hand
retargeting
Robot hand grasping a sage cylinder in a white studio
Geometry-aware hand
retargeting
Human body skeleton and retargeted humanoid side by side
Humanoid
retargeting
Rendered humanoid crouching and climbing on stepped terrain
Geometry-aware humanoid
retargeting
Standing humanoid turning and taking small steps on a white background
Full-body
retargeting
Rendered humanoid interacting with objects and furniture in a kitchen on a white background
Geometry-aware full-body
retargeting

Explore recorded motions and robot presets in the gallery examples.

How it works

flowchart LR
    Source["`Source
    *VR · gloves · mocap · recordings*`"]
    Retargeter["`Retargeter
    *Optimization + Neural*`"]
    Target["`Target
    *Viser · robot hardware*`"]
    Source -- "Frame: hand · arm · body" --> Retargeter
    Retargeter -- "Command: robot joints · base pose" --> Target
    classDef endpoint fill:#dbeafe,stroke:#2563eb,color:#111827
    classDef solver fill:#dbc8ea,stroke:#8163a1,stroke-width:2px,color:#111827
    class Source,Target endpoint
    class Retargeter solver
Component Role Read more
Source Read a device or recording and produce a canonical frame. Sources
Frame Represent human hand, arm, or body motion. Frames
Retargeter Solve hand, arm, or body motion using RoboKit. Interfaces
Command Carry robot joint positions and an optional base pose. Commands
Target Preview commands or send them to a robot. Targets

See the framework overview for frames, commands, and named rigs.

Metadata

Release files for retargetingkit 0.1.0

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

Source distribution (sdist)

Source distribution for retargetingkit 0.1.0
File Size Uploaded Provenance Actions
retargetingkit-0.1.0.tar.gz 117.3 kB Without provenance Details for retargetingkit-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for retargetingkit 0.1.0
File Interpreter ABI Platform Actions
retargetingkit-0.1.0-py3-none-any.whl Python 3 none any Details for retargetingkit-0.1.0-py3-none-any.whl

Total release size: 298.7 kB

Release files / retargetingkit-0.1.0.tar.gz

Download URL retargetingkit-0.1.0.tar.gz
Size 117.3 kB
Tags Source
SHA-256 checksum
How to use checksums
285f6c660fc2691b9a7fea10715f5dda49d40c185f02192e1a83efba04213936
BLAKE2b-256 checksum
How to use checksums
eb7c8bfdecab2d83f2c7ac6651ef5b499b404d997639b95a03847beb0ff66d52
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / retargetingkit-0.1.0-py3-none-any.whl

Download URL retargetingkit-0.1.0-py3-none-any.whl
Size 181.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
461c8770b1a4fe115be8cc3b37f14c89e543a79d006454f422a3ba04071bca0e
BLAKE2b-256 checksum
How to use checksums
5fe4816a462e4fcbcc272b3f92788aaadb0bf2caaae661a3d6fa442f79d641e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for retargetingkit 0.1.0

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.1.0 This release

2 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