Introduction
Overview
Wuji SDK is a universal development kit for all Wuji devices, spanning multiple product lines including data gloves, dexterous hands, and more. It ships Python and C APIs and delivers a consistent development experience across products through unified device management, real-time data subscription, and semantic APIs.
The current release supports the Wuji Glove, Wuji Hand, and Wuji Hand 2 (Beta 1). Both Wuji Hand models are accessible from the SDK:
- Wuji Hand 2 (Beta 1) — Uses Wuji SDK directly. See Wuji Hand 2 SDK Reference.
- Wuji Hand — Now supported directly by Wuji SDK (USB attach, API aligned with Wuji Hand 2). The standalone wujihandpy package remains available, see Wuji Hand SDK Guide.
Core features:
- Device management — Auto-discover Wuji devices on the local network, connect and manage multiple devices in parallel
- Real-time data subscription — Tactile matrix, EMF poses, hand tracking, IMU, and more data streams with async/await and callback modes, plus cross-device merged subscription for multi-device setups
- Data recording — Record multi-channel sensor data to MCAP files with pause/resume, episode switching, and real-time quality monitoring
- Semantic API — Type-safe access through intuitive methods like
glove.tactile(),glove.emf_poses()for direct data retrieval - Device parameter access — Query serial number, firmware version, and other device info, plus modify writable parameters like network configuration
Getting Started
System Requirements
Common:
| Item | Requirement |
|---|---|
| OS | Ubuntu 22+ |
| Network | Ethernet (same subnet as Wuji device) |
Additional, by SDK:
- Python SDK: Python 3.10+
- C SDK: C compiler (gcc / clang)
Installation
| Language | Installation |
|---|---|
| Python | PyPI package wuji-sdk: pip install wuji-sdk |
| C | Download the platform tarball wuji-sdk-c-<version>-<target>.tar.gz from the Releases page. The extracted archive contains lib/libwuji_sdk_c.so and include/wuji_sdk.hSee C API Reference · CMake project example for a CMake example and the minimal link command |
Before using Wuji Glove, complete the hardware connection and network configuration. See Getting Started for details.