HairDeck

HairDeck

把一张角色图片变成风格化的 3D 发片，带颜色和用于动画的弹簧骨骼链，可导出为 GLB 网格或 VRM 虚拟形象，适合有 CUDA GPU 的虚拟形象创作者和 3D 美术。

由 hyz317 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：HairDeck 是一组模型，把一张角色图片变成 3D 虚拟形象用的风格化头发。头发以发片的形式给出，发片是扁平的网格条，每片都有自己的 UV 贴图和颜色，另外还有弹簧骨骼链，让头发在虚拟形象做动画时能动起来。你得到的是 GLB 文件格式的头发网格，也可以把它们装到项目附带的虚拟形象身体上，导出 VRM 0.x 虚拟形象。

适合谁：它适合想从一张图直接得到可做动画的头发，而不是手工制作的 3D 美术和虚拟形象创作者。

Industry | Who uses it | How they use it | Example
游戏 | 3D 美术 | 用一张图为角色做可做动画的头发 | 风格化游戏角色的头发
虚拟形象 | 虚拟形象创作者 | 做一个头发会动的 VRM 虚拟形象 | 导出带弹簧骨骼头发的虚拟形象
动画 | 动画师 | 得到可用于自己工具的 GLB 头发网格 | 把 GLB 头发导入 3D 场景
人工智能研究 | 研究人员 | 研究用于发片的生成模型 | 对比图像路径和点云路径

如果你想要用于电影的照片级发丝，可以跳过它，因为输出是风格化的发片。

用在哪里：

• 带 Python 3.12 和 CUDA GPU 的 Linux 电脑
• 模型卡提供的在线演示，可以先试一试
• 能读取 GLB 文件的 3D 工具，以及能打开 VRM 虚拟形象的应用

Use case | Who | What they get back
从图片生成头发 | 美术 | GLB 文件格式的发片网格
会动的头发 | 虚拟形象创作者 | 让头发动起来的弹簧骨骼链
虚拟形象导出 | 创作者 | 带头发的 VRM 虚拟形象，加一段转头视频

如何设置：

你需要先准备：

• 带 CUDA GPU、运行 Python 3.12 的 Linux 电脑
• 项目在 GitHub 上的代码仓库，模型卡里有链接
• 按模型卡所述，接受 SAM 3 和 DINOv3 的许可并登录 Hugging Face
• ffmpeg，如果你想要视频预览

1. 按代码仓库里的安装说明操作。
2. 同意 SAM 3 和 DINOv3 的许可，然后登录 Hugging Face。
3. 在代码仓库根目录设置工作区文件夹，并运行权重下载脚本。
4. 对你的角色图片运行图像脚本，然后运行导出命令。

pip install -U huggingface_hub
hf download hyz317/HairDeck

如何使用：对你的角色图片运行图像脚本，要求生成四个变体。它们会放在一个 results 文件夹里。然后对其中一个变体运行导出命令，得到 VRM 虚拟形象和一段转头视频。

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

Tool | What it does
download_weights.py | 取回模型权重和额外资源
image_to_hair.py | 根据角色图片生成发片
hairdeck.vrm.export | 为一个变体生成 VRM 虚拟形象和转头视频
ffmpeg | 视频预览需要它

示例：你对一张卡通角色图片运行图像脚本，得到四个头发变体。你选第一个，运行导出命令，得到装好头发的 VRM 虚拟形象。模型卡这里没有展示完成的结果，所以请把它当作预期。

新手与专家：发片是扁平的网格条，上面画着头发的颜色，是游戏里做头发的常见方式。弹簧骨骼是会摆动的链，让头发能动。第一步可以先试在线演示，再去搭建代码环境。

图像路径连接了四个模型。Image DiT 根据图片生成发片 token，Card VAE 把每个 token 变成发片几何，Color DiT 给发片上色，Chain DiT 加上弹簧骨骼链。另有一个单独的点云模型供给另一条路径。

给出一张角色图片
Image DiT 生成发片 token
Card VAE 构建发片几何
Color 和 Chain 模型加上颜色和弹簧骨骼

注意事项：安装会拉入外部模型，每个都有自己的条款。

• 访问: SAM 3 和 DINOv3 需要先接受许可，安装才能正常进行
• 外部模型: Dora-VAE、BiRefNet-matting、SAM 3 和 DINOv3 从各自的仓库拉取
• 评估资源: 可选，默认下载会跳过它们
• License: 这个仓库是 Apache 2.0，外部模型有各自的许可
• Cost to run: 未提及，GPU 由你自己提供
• Data it reaches: 你给它的角色图片，以及从其他仓库取回的额外模型

Hugging Face 上的数据（2026年11月13日）

• 任务：image to 3d
• 框架：pytorch
• Formats: Safetensors
• 最近 30 天下载：3,681
• 点赞：70
• 许可证：apache-2.0
• 标签：pytorch, safetensors, 3d, anime, hair, hair-cards, diffusion, image-to-3d

链接

• 模型：https://huggingface.co/hyz317/HairDeck
• 文件：https://huggingface.co/hyz317/HairDeck/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download hyz317/HairDeck

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。