wujihandros2

June 15, 2026 · View on GitHub

License: MIT Release

ROS2 driver package for Wuji Hand dexterous hand. Provides 1000Hz joint state publishing, real-time control interface, multi-hand setup, and RViz visualization.

Get started with Quick Start. For detailed documentation, please refer to ROS2 Tutorial on Wuji Docs Center.

ROS2 VersionUbuntuBuild StatusDeb Package
Humble22.04CIDownload
Kilted24.04CIDownload

Repository Structure

├── wujihand_bringup/            // Launch files and demo scripts for starting the driver
│   ├── launch/
│   └── scripts/
├── external/
│   └── wuji-description/        // URDF models, mesh files, and RViz configuration (submodule)
├── wujihand_driver/             // Core ROS2 driver node for hardware communication
│   ├── include/
│   └── src/
├── wujihand_msgs/               // Custom ROS2 message and service definitions
│   ├── msg/
│   └── srv/
├── docs/                        // API reference and documentation
└── README.md

Quick Start

Installation

git clone --recurse-submodules https://github.com/wuji-technology/wujihandros2.git
cd wujihandros2
# If already cloned without --recurse-submodules, run:
# git submodule update --init --recursive
source /opt/ros/humble/setup.bash  # or kilted
colcon build
source install/setup.bash

Running

# Launch driver
ros2 launch wujihand_bringup wujihand.launch.py

# Launch with RViz visualization
ros2 launch wujihand_bringup wujihand.launch.py rviz:=true

# Verify operation
ros2 topic echo /hand_0/joint_states --once

Contact

For any questions, please contact support@wuji.tech.