HairDeck: Animation-Ready Stylized Hair Cards
from a Single Image

Yuze He^1,*   Yixiang Wei^1,*   Wang Zhao¹   Chuhao Chen²   Yanning Zhou^3,†   Yong-Jin Liu^1,†

¹Tsinghua University   ²Carnegie Mellon University   ³The Chinese University of Hong Kong

^*Equal contribution.   ^†Corresponding authors.

HairDeck turns a single character image into stylized hair cards with per-card UVs and the spring-bone chains that animate them. Generate hair meshes as GLB files, then attach the hair to the provided avatar body and export a VRM 0.x avatar.

🚀 Try HairDeck

Start with the online demo, or run the models locally with the HairDeck code.

For local use, follow the installation instructions for Linux, Python 3.12 and a CUDA GPU. Accept the SAM 3 and DINOv3 licences and log in as described in model setup. Then, from the code repository root:

export HAIRDECK_ROOT=/path/to/workspace
python scripts/setup/download_weights.py
python scripts/image_to_hair.py character.png --out results/my_character --n 4
python -m hairdeck.vrm.export results/my_character/character 0

download_weights.py downloads the model bundle and supporting assets. Inference writes four variations under results/my_character/character/; the export command creates a VRM and head-turn video for seed 0. Video previews require ffmpeg. See the output guide for the generated files.

🧩 Released models

The image pipeline combines Image DiT + Card VAE + Chain DiT. The point-cloud model is used by the point-cloud generation and evaluation path. Both paths also need the supplied normalization statistics; use the downloader above to obtain the matching files together.

DINOv3, SAM 3, BiRefNet-matting and Dora-VAE are fetched from their own repositories when needed. Their weights are not bundled here. The image model uses DINOv3 ViT-L/16 features, and the point-cloud model uses Dora-VAE 1.1 features.

📦 Supporting assets

This repository also provides normalization statistics, the canonical head frame, the avatar body used for VRM export, and example images. Evaluation assets are optional and skipped by the default download.

Detailed file layout and checkpoint format

The DiT checkpoints contain EMA weights; the Card VAE contains its model weights. Training configuration is stored in the safetensors metadata under hairdeck and read by hairdeck.ckpt.load. Use the HairDeck code to load these checkpoints.

📊 Evaluation

To download the additional test assets and point-cloud encoder:

python scripts/setup/download_weights.py --only test_data charm_test_pc dora

Follow the evaluation guide to run the point-cloud and chain benchmarks. The default tests sample seeds 0, 1 and 2 and save per-sample metrics and their means. Training instructions are in the code repository.

📝 Citation

@misc{hairdeck2026,
  title         = {HairDeck: Animation-Ready Stylized Hair Cards from a Single Image},
  author        = {Yuze He and Yixiang Wei and Wang Zhao and Chuhao Chen and Yanning Zhou and Yong-Jin Liu},
  year          = {2026},
  eprint        = {2610.40599},
  archivePrefix = {arXiv},
  primaryClass  = {cs.CV},
  doi           = {10.48550/arXiv.2610.40599},
  url           = {https://arxiv.org/abs/2610.40599}
}

License

The HairDeck checkpoints are released under Apache-2.0.