> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuji.tech/llms.txt
> Use this file to discover all available pages before exploring further.
# Hand Model Calibration
> Calibrate the glove hand model in the terminal with wuji calib hand-model, saved per user profile
`wuji calib hand-model` runs Wuji Glove hand model calibration in the terminal: select a device, follow the prompts through the motion collection, and the calibration artifacts are saved to the current user profile and take effect immediately.
Hand model calibration is isolated per user, and the Default user can't calibrate. In a terminal, the command can create or switch to a named profile before connecting. For structured or redirected output, use `wuji user create --switch` for a new profile or `wuji user switch ` for an existing profile.
## Usage
```bash theme={null}
wuji calib hand-model # Auto-selects when one device is on the network
wuji calib hand-model --sn # Select by serial number
wuji calib hand-model --handedness left # Select by hand side
```
| Option | Description |
| - | - |
| `--sn `, `--address `, `--handedness ` | Select a device explicitly, optional when only one device is on the network |
| `--timeout-s ` | Overall calibration timeout, default 900 |
## Interactive Flow
In a terminal, the command guides the full session:
1. Review the current profile, then keep it, switch profiles, or create a named profile.
2. Select a Wuji Glove. Each result shows its serial number, connection method, and endpoint.
3. If the profile already has a hand model for the selected hand, confirm whether to replace it. The default is **No**. Declining cancels the session and releases the device.
4. Complete six poses: index, middle, ring, and pinky pinch, a four-finger 90-degree bend, and a flat open hand.
5. Follow the live stability and constraint feedback, then wait while the solver publishes the model.
The terminal shows pose progress and up to eight current diagnostics. A window of at least 81 columns by 38 rows also shows the fixed-size pose guide. A smaller window shows text instructions and asks for a larger terminal before restarting. Press Ctrl+C once to cancel safely and release the device.
### Pose Overview
| Step | Illustration | Pose | Constraint | Key Points |
| - | - | - | - | - |
| 1 | 
| Thumb–index tip pinch | Thumb–index EMF distance \< 5 cm, with the fingertips facing each other at an angle > 100° (tip-to-tip, not pad-to-pad) | Touch only the thumb and index fingertips. Don't press the finger pads together |
| 2 | 
| Thumb–middle tip pinch | Thumb–middle EMF distance \< 5 cm, with the fingertips facing each other at an angle > 100° (tip-to-tip, not pad-to-pad) | Touch only the thumb and middle fingertips. Don't press the finger pads together, and keep the other fingers relaxed |
| 3 | 
| Thumb–ring tip pinch | Thumb–ring EMF distance \< 5 cm, with the fingertips facing each other at an angle > 100° (tip-to-tip, not pad-to-pad) | Touch only the thumb and ring fingertips. Don't press the finger pads together |
| 4 | 
| Thumb–pinky tip pinch | Thumb–pinky EMF distance \< 5 cm, with the fingertips facing each other at an angle > 100° (tip-to-tip, not pad-to-pad) | Touch only the thumb and pinky fingertips. Don't press the finger pads together |
| 5 | 
| Four-finger 90-degree bend | Index, middle, ring, and pinky angles close to the target pose (thumb not constrained) | Bend the index, middle, ring, and pinky fingers together to about 90°—like a half-fist, not clenched, with the thumb relaxed |
| 6 | 
| Flat open hand | Index, middle, ring, and pinky angles close to the target pose (thumb not constrained) | Open the hand fully with all four fingers extended and close together, palm steady, thumb relaxed |
## Calibration Results
On success, the command shows the profile, hand side, path, size, and time of the artifact (`left_hand.urdf` or `right_hand.urdf`). The result takes effect immediately. Choose **User show** to inspect the full profile, **Recalibrate** to start another hand-model session, or **Finish** to exit. Move the result between machines with `wuji user export`.
## Automation
`--json` prints the final result object. `--jsonl` streams `progress` events, followed by a final `result`, `error`, or `cancelled` event. Every object carries `schema_version: 2` and `calibration: "hand_model"`, so scripts can identify and parse them accordingly. These modes do not show profile, device, or overwrite prompts. Select a named profile and check whether it already has a hand model for the same side before starting. The command starts calibration directly and attempts to replace an existing model when calibration finishes. If publishing the new model fails, the existing model remains unchanged.
| Exit Code (`error.code`) | Meaning |
| - | - |
| 0 | Calibration succeeded |
| 5 | The Default user can't run hand model calibration |
| 9 | Cancelled by the user |
| 1 | Other runtime error |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.