Documentation Guide

GitHub Repositories and Docs Entry Points

The table below summarizes Wuji Hand repositories, use cases, and recommended reading entry points.

CategoryRepositoryVersionUse caseReading entry
Software Toolswujihand-upgraderv4.1.1Firmware upgrade tool for Wuji HandUpgrader User Guide
wujihand-hmiv1.5.1Real-time device monitoring, calibration, and debugging for Windows and LinuxHMI User Guide
Developer Guidewujihandpyv1.8.0C++ core with Python bindings, for controlling and communicating with Wuji HandSDK User Guide
wujihandros2v1.1.01000Hz joint state publishing, real-time control interface, multi-hand setup, and RViz visualizationROS2 User Guide
wuji-retargetingv2026.6.15High-precision retargeting based on DexRetargeting, supporting Vision Pro hand tracking for real-time teleoperationRetargeting User Guide
wuji-hand-teleopv2026.6.13Real-time Wuji Hand and robot arm control with multiple input devices
  1. GitHub README
  2. Retargeting User Guide
  3. ROS2 User Guide
Referencewuji-descriptionv2026.6.12URDF, MJCF, and USD models plus STEP/CAD assets for simulation, visualization, and mechanical integrationDescription User Guide
mujoco-simno releaseMinimal demo for loading and controlling Wuji Hand in MuJoCo simulator
  1. GitHub README
  2. Description User Guide · MuJoCo Simulation Example
isaaclab-simv0.2.0Minimal demo for loading and controlling Wuji Hand in IsaacSim simulator
  1. GitHub README
  2. Description User Guide · Isaac Lab Simulation Example

Available Documentation

Changelog

Version updates and changelog for firmware, SDK, HMI, ROS2 driver, and other components

Product Introduction

Hardware specs, structure, electrical characteristics, and installation guide

User Notice

Safety precautions and legal terms for operating Wuji Hand

Upgrader User Guide

Install and use Wuji Hand Upgrader for firmware updates

HMI User Guide

Control and monitor Wuji Hand using the HMI desktop application

SDK User Guide

Python/C++ SDK for programmatic control of Wuji Hand joints

  • Getting Started
    Install wujihandpy, run quick start example, and learn core concepts
  • Tutorial
    Device connection, sync/async read-write, real-time control, multi-threading, and USB disconnect handling
  • API Reference
    Complete field list and method reference for Hand, Finger, Joint, and TactileGlove

ROS2 User Guide

ROS2 driver for high-frequency joint control and visualization

  • Installation
    Install SDK and ROS2 driver via source build or deb package
  • Quick Start
    Launch driver, verify joint states, run demo, and open RViz
  • Configuration
    Launch parameters, multi-hand setup, and joint naming conventions
  • ROS2 Interface
    Message types, service calls, topic control, and code examples
  • Appendix
    Troubleshooting, error code reference, and related resources

Retargeting User Guide

Map human hand poses to Wuji Hand joint angles in real time

  • Installation
    Clone repo, install dependencies, and configure Apple Vision Pro
  • Quick Start
    Run simulation demo and real hardware teleoperation examples
  • Tuning Guide
    tuning_tool usage, segment_scaling, parameter quick reference, recommended tuning order
  • API Reference
    Retargeter usage, input/output formats, and configuration parameters
  • Appendix
    Optimization algorithm principles, troubleshooting, and resources

Description User Guide

Model description package for the hand and related hardware, covering simulation, visualization, and mechanical integration

Technical Support

For technical support or any questions, please contact us: support@wuji.tech