wuji-sdk 2026.5.26

Wuji SDK: Python package for automatic device discovery and real-time data streaming with Wuji devices.

wuji-sdk

Python SDK for Wuji series devices. Provides automatic device discovery, connection management, and real-time data streaming for Wuji Glove, Wuji Hand 2, and other Wuji peripherals. Features type-safe semantic API with native async/await and callback-based subscription support, multi-channel MCAP recording, and rich hand tracking data including joint angles, skeleton, and fingertip poses.

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

Repository Structure

├── examples/                      # Example scripts demonstrating SDK usage patterns
│   ├── wuji_glove/                # Wuji Glove examples
│   │   ├── 0.subscribe_callback.py    # callback subscription (tactile, EMF, skeleton)
│   │   ├── 1.subscribe_async.py       # async/await subscription
│   │   ├── 2.recording.py             # record to MCAP with TopicRecorder + LZ4
│   │   └── 3.offline_pipeline.py      # offline IK / fusion pipeline (no device required)
│   └── wuji_hand_2/               # Wuji Hand 2 examples
│       ├── 0.subscribe_callback.py    # callback subscription (joint_state)
│       ├── 1.subscribe_async.py       # async/await subscription
│       └── 2.publish.py               # joint_command publisher demo (200 Hz pos hold)
├── CHANGELOG.md                   # Version history and release notes
├── LICENSE                        # MIT license file
└── README.md

Quick Start

Installation

pip install wuji-sdk

Running

import time
from wuji_sdk import SdkManager

manager = SdkManager.instance()
devices = manager.scan()
if not devices:
    print("No devices found")
    exit()
glove = manager.connect(sn=devices[0].sn, device_name="glove")

sub = glove.tactile().subscribe_with_callback(
    callback=lambda frame: print(f"Max pressure: {max(frame.data):.2f}")
)

time.sleep(10)
sub.close()

Contact

For any questions, please contact [e-mail].