HairDeck, from Tsinghua University, turns one picture of a stylized character into 3D hair made of hair cards, the textured strips games and VTuber avatars use. Each card comes with UVs and the colours of the picture, and the model also generates the spring bones that make the hair swing when the character moves. It is open (Apache-2.0), but setting it up needs a CUDA GPU, two gated Meta models and Blender. On LiveWeights you upload the picture and download the result.
HairDeckTsinghua University (Yuze He et al.) · Apache-2.0 (SAM 3 and DINOv3 under their own licenses)From one picture of a stylized character to 3D hair cards with colours, UVs and spring bones, ready to animate in a VRM avatar.Try it online →What HairDeck generates
- Hair cards as a set: each card is one token, and a set diffusion transformer generates the whole hairstyle at once, so strands, bangs and twin tails stay consistent.
- Colours from the picture: a colour model predicts the colours along every card, including two-tone hair and accessories like ribbons.
- Animation-ready: a second model generates the spring-bone chains and the skinning that drive the cards.
- Two files: a GLB with the hair and a reference head, and a VRM avatar with the new hair and its spring bones, ready for VRoid-compatible apps, VTubing tools and game engines.
License: can I use it commercially?
HairDeck's code and weights are Apache-2.0. It relies on Meta's SAM 3 (SAM License) and DINOv3 (DINOv3 License), both of which allow commercial use. The hair you generate on LiveWeights is yours; check the rights of the character picture you start from.
How to try it online
- Open the HairDeck page and sign in, then pick a small credit pack (no subscription).
- Upload a picture of a stylized character (anime, game or cartoon style), ideally from the front with the whole hairstyle visible. Transparent PNGs work well.
- Press Generate hair. After about a minute you can orbit the hair in the 3D viewer.
- Download the GLB or the VRM. Change the seed for another take on the same hairstyle.
Tips for better results
- Front or three-quarter views work best: hair hidden behind the head has to be guessed.
- Busy backgrounds are removed automatically, but a clean cut-out helps.
- For a single object rather than hair, try IDOL, which turns a photo into a 3D Gaussian splat.
Run it locally
The code is hyz317/HairDeck on GitHub, with weights on Hugging Face. It runs on Linux and Windows with an NVIDIA GPU (Python 3.12, PyTorch 2.8) and on Apple silicon through MPS. Accept the SAM 3 and DINOv3 licences on Hugging Face, run scripts/setup/download_weights.py (it also installs Blender 4.2 with the VRM Add-on), then scripts/image_to_hair.py. A Gradio demo is included.