Registry / ai-ml / dex-retargeting

dex-retargeting

JSON →
library0.5.0pypypiunverified

Dex Retargeting is a Python library for retargeting hand poses from human hand models to dexterous robot hands. It supports multiple retargeting methods (e.g., keypoint-based, joint angle mapping) and is designed for use in robot learning and teleoperation. Version 0.5.0 has a nightly release cadence, with active development. Requires Python >=3.7, <3.13.

pip install dex-retargeting
INSTALL
IMPORT
SIG · DEX-RETARGETING
D
dex-retargeting
ai-mlpythonv0.5.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

PoseRetargeting
from dex_retargeting import PoseRetargeting
from dex_retargeting.retargeting import PoseRetargeting

Load a retargeting function and apply it to a source hand pose (e.g., MANO joints). The function returns robot-specific joint angles.

import numpy as np from dex_retargeting.retargeting import retarget # Example: retarget a single hand pose source_pose = np.random.rand(21, 3) # MANO hand joints robot_joints = retarget(source_pose, robot_name='allegro') print(robot_joints)
Debug
Known issues
gotchaThe retarget function expects source poses in a specific joint order (MANO convention). Using incorrect ordering will silently produce wrong results.
fix
Ensure your input joints follow the MANO hand joint ordering (21 joints in specific order). Refer to the model documentation.
affects: all
deprecatedThe 'robot_name' parameter in retarget() is deprecated in favor of passing a robot config object in future versions. Current version still supports string names, but will be removed.
fix
Use a robot configuration object: `from dex_retargeting.robot_config import get_robot_config; robot_cfg = get_robot_config('allegro'); robot_joints = retarget(source_pose, robot_cfg)`
affects: >=0.4.0,<0.6.0
breakingPython 3.13 and above are not supported due to <3.13 constraint.
fix
Use Python 3.7-3.12.
affects: current
Upgrade
Version history
0.5.0latest on PyPI · released Apr 5, 2025
Audit
Dependencies

No dependency data recorded yet.

Agent activity
18 hits · last 30 days
node
14
OpenAI (training)
1
Resources
dex-retargeting — pip install dex-retargeting · libregistry