wuji-sdk 2026.6.16

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

wuji-sdk (Python)

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 a 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.

For detailed documentation, see the Wuji Docs Center.

Looking for the C SDK? See the C SDK README.

Installation

pip install wuji-sdk

When running examples from this repository against local source changes, rebuild and install the Python extension into the active virtual environment first:

cd crates/sdk-python
maturin develop

Quick Start

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()

More examples: examples/python/.

Examples

• wuji_glove/0.subscribe_callback.py: subscribe to glove streams with callbacks; also prints the realtime-IK hand model selection.
• wuji_glove/1.subscribe_async.py: subscribe to glove streams with async/await; also prints the realtime-IK hand model selection.
• wuji_glove/2.recording.py: record glove data to MCAP.
• wuji_glove/3.offline_pipeline.py: run hand tracking from offline frames.
• wuji_glove/4.user.py: inspect, create, and switch local SDK users.
• wuji_glove/5.calibration.py: run IK calibration with terminal guidance or API-style callbacks.

License

MIT