---
license: apache-2.0
tags:
- dex-hand
- teleoperation
- retargeting
- mujoco
- assets
---

# somehand-assets

External asset repository for `somehand`.

## Contents

This model repo stores runtime assets and sample data that are intentionally kept out of the code repository:

- `archives/mjcf_assets.tar.gz`: packaged MJCF hand assets and meshes under `assets/mjcf/`
- `models/hand_landmarker.task`: MediaPipe hand landmarker model under `assets/models/`
- `archives/reference_assets.tar.gz`: reference BVH assets, currently including `assets/ref_with_toe.bvh`
- `archives/sample_recordings.tar.gz`: sample replay recordings and short rendered examples under `recordings/`

## Suggested download commands

### ModelScope

```bash
export SOMEHAND_MODELSCOPE_REPO_ID=BingqianWu/somehand-assets
python scripts/setup/download_assets.py --only mjcf mediapipe examples
```

### Hugging Face

```bash
export SOMEHAND_HF_REPO_ID=12e21/somehand-assets
python scripts/setup/download_assets.py --source huggingface --only mjcf mediapipe examples
```

## Notes

- This repo is a **model repo** so asset updates are versioned as commits.
- The main `somehand` code repository should not store these large binaries directly.
- Sample recordings are provided for replay, visualization, and regression-style checks.