|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
wuji_description repositorywuji_description wuji_hand2_beta1_description wuji_hand2_beta2_description |
ROS Distro
|
Repository Summary
| Checkout URI | https://github.com/wuji-technology/wuji-description.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-08-19 |
| Dev Status | DEVELOPED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| wuji_description | 2026.04.27 |
| wuji_hand2_beta1_description | 2026.8.19 |
| wuji_hand2_beta2_description | 2026.8.19 |
README
wuji-description
Robot model description package for the Wuji Hand and related accessories. Provides URDF, MuJoCo (MJCF), and USD assets for simulation and visualization, plus STEP/CAD files for mechanical integration. Includes a ROS2 launch and RViz configuration for quick inspection of left and right hand models.
Get started with Quick Start. For detailed documentation, please refer to Wuji Description on Wuji Docs Center.
Repository Structure
.
├── hand/
│ ├── body/ // ROS2 package: simulation and visualization assets for the hand body
│ │ ├── launch/display.launch.py // ROS2 launch file (selects left or right hand)
│ │ ├── meshes/{left,right}/ // STL meshes for visual and collision geometry
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models
│ │ ├── rviz/{left,right}.rviz // RViz presets
│ │ ├── step/ // Simplified structural STEP files of the hand frame
│ │ ├── urdf/{left,right}.urdf // URDF models (relative mesh paths, for local tools)
│ │ ├── urdf/{left,right}-ros.urdf // URDF models (package:// paths, for ROS2)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ ├── body-with-soft/ // Hand variant with a soft pad on the thumb
│ │ ├── meshes/{left,right}/ // STL meshes, including soft-pad and simplified collision meshes
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_simplified.xml)
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros and _simplified variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (plus {left,right}_simplified/)
│ │ └── params.csv // Actuator parameters
│ └── attachment/
│ ├── impact-resistant-attachment/ // Impact-resistant docking link (STL, URDF, MJCF, USD)
│ ├── step/ // Adapter STEP files, assembled PDFs, and installation notes
│ ├── unitree-g1-attachment/ // STL adapter for mounting on Unitree G1
│ └── wuji-hand-rl-open-source-base/ // Open-source mounting base for RL setups (3MF, STEP, PDF, BOM)
├── hand2/
│ ├── hand2_beta1/
│ │ ├── body/ // ROS2 package wuji_hand2_beta1_description: Wuji Hand 2 (Beta 1), coordinate conventions frozen
│ │ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ {l,r}_mount.STL for the with-mount variant)
│ │ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ │ ├── step/ // Full-hand STEP CAD assemblies
│ │ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2.usd; plus {left,right}_with_mount/)
│ │ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ │ └── package.xml // ROS2 package manifest
│ │ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
│ └── hand2_beta2/
│ ├── body/ // ROS2 package wuji_hand2_beta2_description: Wuji Hand 2 (Beta 2), Beta 1 + one tactile sensor pad per fingertip
│ │ ├── meshes/{left,right}/ // STL meshes with anatomical names (+ tip sensor pads, + {l,r}_mount.STL)
│ │ ├── mjcf/{left,right}.xml // MuJoCo XML models (plus {left,right}_with_mount.xml)
│ │ ├── step/ // Full-hand with-mount STEP CAD assemblies
│ │ ├── urdf/{left,right}.urdf // URDF models (plus -ros.urdf package:// and _with_mount variants)
│ │ ├── usd/{left,right}/ // Isaac Sim USD assets (layered wujihand2_beta2.usd; plus {left,right}_with_mount/)
│ │ ├── CMakeLists.txt // ROS2 package install rules
│ │ └── package.xml // ROS2 package manifest
│ └── attachment/ // Palm mounting-interface STEP + A3 dimensioned drawing, one pair per hand
├── glove/
│ ├── body/ // Wuji Glove model (hand motion tracking)
│ │ ├── urdf/{left,right}.urdf // URDF skeletons (21 revolute DOF per hand)
│ │ ├── mesh/base_link_{TX,RX}.STL // Transmitter base and fingertip receiver coil
│ │ └── step/EMFTXC_topcover.{step,pdf} // Transmitter top-cover STEP and assembled drawing
│ └── attachment/ // Glove mounting attachments (STEP CAD assemblies)
│ ├── Wuji-glove-attachment.STEP // Wuji Glove mounting interface
│ ├── Pico-tracker-attachment.STEP // Adapter for mounting a PICO tracker
│ └── Pico-controller-attachment.STEP // Adapter for mounting a PICO 4 Ultra controller
├── CHANGELOG.md
├── LICENSE
└── README.md
Quick Start
Installation
git clone https://github.com/wuji-technology/wuji-description.git
cd wuji-description
Hand Body
MuJoCo
# Right hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/right.xml
# Left hand
python -m mujoco.viewer --mjcf=hand/body/mjcf/left.xml
ROS2 and RViz
hand/body/ is the ROS2 package source (wuji_description). The package installs hand/attachment/ as a sibling resource, so clone the entire repository into your workspace src/ rather than copying hand/body/ in isolation:
```bash
Source ROS2 environment, replace with your installed ROS2 distribution
source /opt/ros/
cd ~/ros2_ws/src
File truncated at 100 lines see the full file