Stringers
hyz317/HairDeck · hyz317

A standing portrait grows swaying hair: how HairDeck gained 318 stars in a day from the Japanese VRM scene

What it is You upload a single anime character image, and it generates separate hair strands plus a bone rig that makes the hair sway, which you can export straight onto a VRM avatar.

Why it took off Its output is exactly the finished format VRChat and VTuber players want. Japanese 3DCG news account MODELING HAPPY posted about it, and it gained 318 stars the next day. The code and demo went up the same day, followed by an update every day or two, which kept giving people new reasons to repost.

BHow you can follow it Don't copy the hair model; learn the approach. Build the next component for the same VRM player ecosystem (clothing, hair accessories, animal ears) with a rig and direct VRM export, or fill the Unity / Unreal plugin gaps it leaves. Write a trilingual README in Chinese, Japanese and English, and actively pitch it to Japanese 3DCG news sites and Bilibili modpack uploaders.

Grade B: the "target the format players can use directly" path is clear, there's room in the VRM scene, and few people know about it yet. But the stars really go to the research model itself, and keeping up requires training ability and data. Pure wrapping (a ComfyUI node with 2 stars) doesn't earn stars. It's circulating in small circles
Data (updated daily) · Repo created 2026-10-29 · 863 stars · 7 days +601
GitHub · stars
25050075011-0111-0311-0511-0611-08863
Data 2026-11-01 → 2026-11-08 (8 days, 8 observations). Points before 10-28 come from deeply / archive backfill, not every day has one

HairDeck is paper code from a PhD group at Tsinghua. Give it one anime character image and it generates individual hair strands, then a bone rig that makes the hair sway, exportable as a VRM avatar. The repo is 8 days old and has 849 stars. The stars didn't come from Hacker News or big English AI accounts. They came from a Japanese 3DCG news account. It has many research peers, but it got stars because what it outputs is immediately usable by VTubers and VRChat players.

A Nov 1 noon post

2026 年 11 月 1 日中午 12 点半(日本时间),日本 3DCG 资讯站 MODELING HAPPY 发了一篇文章,X 上同步发帖,标题是「HairDeck——从一张图自动生成动漫风 3D 头发和让头发摆动的骨骼!支持导出 GLB、VRM,免费 demo 已公开」。帖子把卖点列成几个勾:骨骼、毛束形状和 UV、VRM、免费 demo。文章里专门提了一句:一般的单图生成 3D,头发会和身体糊成一整块网格;HairDeck 保留了一片片独立的发片,每片都带 UV。官网演示里,角色一转头,头发晚半拍才跟过来。

This post hit 23.8k views, 440 likes, and 463 bookmarks (on X, 11-06 to check). More bookmarks than likes means people are saving it to come back to. The same day, a Bilibili video called "HairDeck single-image stylized hair package" appeared: 1 min 50 sec, and it has 21.3k plays as of 11-06.

The next day, the repo went from 262 to 580 stars, +318 in one day, its biggest day so far.

What it actually does

For people making VRChat avatars or VTuber models, hair is always the hardest part. Anime hair in games and avatars isn't individual strands. It's dozens of textured "hair cards" layered together, and they need spring bones to sway. Until now there were two options: hand-paint each card in VRoid Studio (via pixiv), or buy ready-made hairstyle assets on BOOTH, which will never match the character you drew.

HairDeck turns that step into "upload one character portrait." The model treats the whole hairstyle as a set of hair strands, generates them all at once, then uses a second model to generate the bone chain that drives them. Finally it calls Blender and a VRM plugin to attach the hair to the avatar and export. Starting Nov 5, it can also read colors from the image, so two-tone hair and hair accessories come through.

The author, Yuze He (on GitHub as hyz317), is on his third anime-character project. The earlier ones were StdGEN, which generates a whole character from one image (406 stars), and CHARM, anime hairstyle generation (60 stars). The paper says HairDeck's geometric error is 44% lower than CHARM's and it runs 33 times faster, but almost no one sharing the post mentions those numbers.

How the stars grew

DateWhat happenedStars
10-29arXiv paper published, GitHub repo created—
10-30Code, weights, and a Hugging Face online demo released the same day; the author submitted the paper to HF Daily Papers, 32 likes—
10-31English 3D AI account @Stefan_3D_AI posts "Finally! Rigged hair cards from a single image"—
11-01MODELING HAPPY post and the Bilibili package262
11-02Windows support added; comfyui-wiki, shader.jp, and modelingtechnote follow with coverage580(+318)
11-03Apple Silicon Mac support added; third-party ComfyUI nodes and a Pinokio one-click install appear733
11-04 ~ 0611-05 adds colored hair cards774 → 808 → 830

Data: GitHub stars tracked daily; on 11-06 the GitHub page showed 849 stars and 60 forks.

A few things to note:

The Japanese community picked it up first. The author had a Japanese README from day one, plus Chinese README and download notes for local weights. Japanese sites and Bilibili got more traction than the English side. English coverage was just @Stefan_3D_AI, an aiweekly news item, and two small YouTube videos. Hacker News had nothing, and Reddit only one reposted link.

Updates never stopped. The online demo worked on day one. After that came 11-02 for Windows, 11-03 for Mac, and 11-05 for color, roughly one update every day or two, each giving newsletters and package makers a reason to post again.

The spike was one-time. After the peak, the repo gained only 20 to 40 stars a day. It's the typical curve of something carried by one event, then slow growth.

Who's doing something similar

ProjectLaunchedStars / scaleDifference
CHARM (same author)2025-0960 starsVery similar research, but no bones and no VRM export, so players can't use it directly
StdGEN (same author)2024-11406 starsGenerates a whole character, hair is one solid mesh
PAniC-3D2023-03832 starsReconstructs the whole anime avatar, not animatable
DiffLocks, HairStep, Im2Haircut, etc.2023–202565~210 starsRealistic strand reconstruction, aimed at real-person digital humans
Meshy, Tripo, Hunyuan3DFrom ¥2023Large user basesHair and body are one mesh, no bones
VRoid Studio hair editorFrom ¥2018The standard tool in the VRM ecosystemHand-painted hair cards, can't generate from an image
BOOTH hairstyle assets—Lots of paid assetsReady-made, can't customize from your image

"One image → stylized hair cards + bones + VRM" hasn't shown up from a second player in either academic projects or commercial products. The followers so far are wrappers, not clones: one ComfyUI node (2 stars), one Pinokio one-click installer, one Bilibili package.

The clearest signal is CHARM vs. HairDeck: same author, same topic, and not a big research gap. One has 60 stars, the other 849. The difference is whether the output drops straight into tools players already use.

What's still in the way

Running it locally needs an NVIDIA GPU (or an Apple Silicon Mac), and you first have to request Meta's gated SAM 3 and DINOv3 weights on Hugging Face. Normal players will struggle to set it up. One YouTube video is titled "I Tested the Space (and It Broke)." The repo has two issues total: one person reporting a finished ComfyUI node, and another asking whether the mesh can be converted into Unreal Engine groom hair. How many people actually put the generated hair into their own avatars isn't visible from outside.

If it were you

My read: The lesson here is "ship the output in a format players can use directly," not "build a better hair model." Copying HairDeck directly won't earn stars. Using its approach for the next VRM part is a real opportunity.

Who it's for: Grad students and research groups working on 3D generation and character generation who have the models but lack distribution; or developers who know the Blender, Unity, and VRoid pipelines and can write plugins.

Who it doesn't fit: People who can't train models and only want to make a wrapper. The ComfyUI node with 2 stars already shows a bare wrapper won't get much. It's also not for anyone trying to beat it head-on in hair. The original author has already published three papers on this, and the dataset is his too.

How to do it: Three paths, ordered from most to least confidence:

  1. Target the same player ecosystem with other parts: generate clothing, accessories, tails, or animal ears from one image as VRM items, with bones and direct VRM export, following HairDeck's format. (My inference: nobody is doing this yet. The hard part is training data.)
  2. Fill the gap HairDeck left: issues show people asking about Unreal groom, and Unity, Unreal, and VRoid import plugins are still empty. Or build a version that works after install without requiring gated weights (check the SAM 3 and DINOv3 licenses first).
  3. If you already have a paper stuck at the research-representation stage, add the step "export to a file a specific tool can open" before you publish.

How to get users: Ship code, weights and a playable demo on day one; write the README in Chinese, Japanese and English; make the demo a short video where the effect is obvious at a glance (like hair swaying when you turn your head); hand it directly to Japanese 3DCG news sites like MODELING HAPPY and shader.jp, and to Bilibili uploaders who make bundles; then post a platform or feature update every day or two. HN and English Reddit didn't do much for this kind of thing. HairDeck didn't rely on them.

Before when: If you're building downstream plugins, move now while HairDeck's buzz is still hot, roughly the next two to three weeks. Other VRM part ideas aren't as urgent, but once the big players' image-to-3D tools start splitting parts and exporting rigs, this gap closes.

What would mean I read it wrong: (1) A month from now HairDeck still gains only a dozen stars a day, and nobody on BOOTH or X is posting avatars made with it. That would mean players bookmark it without really using it, and "matching the player format" is overrated. (2) Someone builds a Unity or Unreal plugin and it's still under 100 stars after a month. That would mean downstream wrappers don't earn stars. (3) Meshy, Tripo, or Hunyuan3D ships "with bones, split into hair cards." That would mean this category gets absorbed by big companies quickly.

Data and sources: GitHub repo page, README change log, issues, and daily star history (11-01 to 11-06); arXiv 2610.40599 and project page; Hugging Face model, Space, and Daily Papers pages (11-06); MODELING HAPPY 2026-11-01 article and X post @happy_modeling; X posts from @Stefan_3D_AI (10-31) and @AICUai; Bilibili BV1ABxs6yEMa; comfyui-wiki, shader.jp, modelingtechnote, and aiweekly coverage; visualbruno/ComfyUI-HairDeck and the Pinokio page; competitor GitHub star counts (11-06).

GitHub repo ↗

Research notes: competitor table, acquisition evidence, full research report
Competitors
NameWhereLaunchedScaleHow it differs from this one
CHARM (same author)Open source2025-0960 starsAutoregressive anime hairstyle generation, no bones and no VRM export. The HairDeck paper says it's 44% lower in Chamfer distance and 33 times faster
StdGEN (same author)Open source2024-11406 starsSingle-image full character generation, hair is one mesh with no hair-card split
PAniC-3DOpen source2023-03832 starsReconstructs the whole anime avatar, not animatable
DiffLocks / Im2Haircut / HairStepOpen source2023–202565–210 starsRealistic strand reconstruction for real people, not stylized hair cards
Meshy / Tripo / Hunyuan3DWebFrom ¥2023Large user basesHair and body merged into one mesh, no hair cards and no bones
VRoid Studio hair editorOther2018The standard tool in the VRM ecosystemHand-made hair cards, can't generate from an image
BOOTH hairstyle assetsOther—Lots of paid assetsReady-made hairstyles, can't customize from an image
Where users come from
  • Verified Japanese 3DCG news account (X + website): @happy_modeling's post on 11-01 got 23.8k views / 440 likes / 463 bookmarks, and the next day the repo gained +318 stars; shader.jp, modelingtechnote, and AICU followed up; the author prepared a Japanese README
  • Verified Chinese Bilibili and AIGC sites: Bilibili BV1ABxs6yEMa package with 21.3k plays; Chinese comfyui-wiki, arxivdaily, and CSDN explainers.
  • Confirmed English 3D AI accounts and AI news aggregators: @Stefan_3D_AI 10-31 post, aiweekly.co, two YouTube videos
  • Verified HF Daily Papers: listed at 10-30, 32 likes, submitted by the author himself.
  • Verified Ecosystem wrappers (ComfyUI / Pinokio): ComfyUI-HairDeck and a Pinokio installer appeared by 11-03.
  • Inferred HN / Reddit: HN Algolia returns nothing; Reddit not checked (blocked)

Why HairDeck (hyz317/HairDeck) took off

Channel: GitHub open source (academic paper code) | Research day: 2026-11-06 | Data card: gh_hyz317/HairDeck

One line

Code from a paper by Yuze He's group at Tsinghua (with CMU and CUHK): input a character image and it generates individual stylized hair cards and the spring bones that make them sway, exports directly as GLB or attaches to a VRM avatar. Stars went from 0 to about 830–849 over 8 days. The stars were driven by the head-of-the-pack signal in Japan's VRM/3DCG community, not HN, Reddit, or big English AI accounts. It caught this wave because its output format is exactly what VRChat and VTuber users can plug in directly (cards + bones + VRM).

1. Numbers and timeline

Date (UTC)EventSource
10-27HF model repo and Space set upHF API(createdAt)
10-29arXiv paper released 2610.40599; GitHub repo created 17:16arXiv, GitHub API
10-30Official release of code, weights, and online demo. The authors submitted the paper to HF Daily Papers themselves and got 32 upvotesREADME Updates, HF papers API
10-31English 3D AI account @Stefan_3D_AI posted "Finally! Rigged hair cards from a single image"; aiweekly.co wrote a news briefx.com/Stefan_3D_AI/status/2116475792331022690, aiweekly.co
11-01 03:36Japanese ModelingHappy (@happy_modeling) posted: 23.8k views, 440 likes, 463 bookmarks, 53 reposts, and also published an on-site article at modelinghappy.com/archives/71347x.com/happy_modeling/status/2116736188942057666
11-01A Bilibili video "HairDeck single-image stylized hair generation bundle" went up, 21.3k playsbilibili BV1ABxs6yEMa
11-01 → 11-02Stars rose from 262 to 580 (+318 in a single day, the highest of the whole run)our GitHub repo_day
11-02Added Windows support; Japanese sites such as comfyui-wiki (Chinese/English), shader.jp, and modelingtechnote followed with coverageREADME, various sites
11-03Added Apple MPS support; third parties released a ComfyUI wrapper visualbruno/ComfyUI-HairDeck and a one-click installer on Pinokio (mumblebox); AICU posted a hands-on testGitHub, pinokio.co, x.com/AICUai
11-05Added colored hair cards (color model)README
11-06830 stars / 59 forks (our library); GitHub API showed 849 that dayrepo_day, gh api

Star curve (repo_day): 11-01 262 → 11-02 580 → 11-03 733 → 11-04 774 → 11-05 808 → 11-06 830. After the peak it only added 20–40 per day: a one-off event-driven spike, followed by slow long-tail growth. HF model downloads 1962, Space 26 likes, model 43 likes (HF API, 11-06).

2. Competitors

ProductWhereLaunchedScaleHow it differs from HairDeck
CHARM (same author)Open source2025-09(SIGGRAPH Asia 2025)60 starsPredecessor: autoregressively generates anime hairstyles one control point at a time, no bones. The HairDeck paper claims 44% lower Chamfer distance and 33x faster (1.33s vs 67.7s). It did the research work, but got no stars. The difference is whether it exports usable assets directly
StdGEN (same author)Open source2024-11(CVPR 2025)406 starsSingle-image generation of a full 3D character (semantic decomposition), hair as one mesh block, no cards and no bones
PAniC-3DOpen source2023-03(CVPR 2023)832 starsSingle anime avatar image reconstructed into 3D as a whole; not animatable
DiffLocks(Meshcapade)Open source2025-04(CVPR 2025)196 starsRealistic strand reconstruction aimed at real-human digital avatars, not stylized cards
Im2Haircut / HairStep / MonoHairOpen source2023–202565 / 210 / 142 starsAll realistic strand reconstruction; outputs can't go directly into VRM or games
Meshy / Tripo / Hunyuan 3D and other image-to-3D toolsWeb / big companiesFrom ¥2023Large user basesHair and body merged into one mesh; no card split, no bones, can't sway
VRoid Studio (pixiv) hair editorDesktop appFrom ¥2018De facto standard of the VRM ecosystemHand-drawn cards with automatic bone rigging; not generated from an image. HairDeck fills exactly the "pick a hairstyle from a picture" step
Hairstyle assets sold on BOOTHMarket—Lots of paid assetsReady-made hairstyles; can't be customized to a given image
CGDream "AI hair 3D model generator"WebNot verifiedNot verifiedA general image-to-3D tool with a hair label on it; output is neither cards nor bones

Conclusion: the combination "single image → stylized hair cards + spring bones + VRM" has not been seen from a second player, neither in academia nor in commercial products. The closest academic neighbor is CHARM from the same author; the closest commercial one is VRoid's manual workflow.

3. Where users came from (growth tactics)

  1. Japanese 3DCG/VRM news accounts (confirmed, the main driver): ModelingHappy's post 11-01 got 23.8k views and 463 bookmarks. Bookmarks outnumbered likes, which means it was saved to come back to later, a practical tool post. Stars jumped +318 in a single day the next day. shader.jp, modelingtechnote, AICU, ism.pupu.jp and other Japanese sites followed with coverage. The author also prepared a Japanese README (README_ja.md); this community is the one he aimed at.
  2. Chinese AIGC community (confirmed): Bilibili bundle video 21.3k plays (11-01); the Chinese comfyui-wiki, arxivdaily, themoonlight Chinese commentary, and CSDN all wrote explainers; there is also a Chinese README and domestic weight download instructions.
  3. English 3D AI accounts and AI news aggregators (confirmed, smaller volume): @Stefan_3D_AI (10-31), aiweekly.co, two YouTube videos "AI Research Roundup" and "I Tested the Space", claudegpt.si, artrealmai.
  4. HF Daily Papers (confirmed): 10-30 ranking, 32 upvotes, submitted by the authors themselves; routine academic exposure.
  5. Ecosystem repackaging (confirmed): ComfyUI nodes, the Pinokio one-click installer, and the Bilibili bundle. Non-programmers can use it without setting up an environment, widening the reach another circle.
  6. HN / Reddit (not found): HN Algolia returns no HairDeck posts; Reddit turned up only a Lemmy cross-post in the stable_diffusion community.
  7. Ads and paid acquisition: none seen, and an academic project doesn't need them.

4. Why it took off

  • The output is the finished format VRM players want: individual hair cards with UVs, plus spring bones, that attach straight to a VRM avatar. Changing hairstyles in VRChat or as a VTuber used to mean hand-drawing in VRoid or buying on BOOTH. This is the selling point ModelingHappy's post listed (✓bones ✓strand shape & UV ✓VRM ✓free demo).
  • Lowered the barrier from day one: code, weights, and the HF online demo were released the same day; over the next 5 days Windows, Mac MPS, and colored cards were added. Each update gave news accounts and bundle makers a new reason to repost.
  • Trilingual README, aimed at the two most active anime 3D communities: Japanese and Chinese reshares were bigger than English.
  • The author has a track record: StdGEN (406 stars) and CHARM (60 stars) both worked on anime characters and anime hair; this is the third paper. CHARM didn't take off because it only produced a research representation that players couldn't use. HairDeck added bones and VRM export, making it actually usable.
  • The demo video is itself shareable: the effect of hair swaying when the head turns is understood at a glance.

5. Differentiation

The differentiator is the output form, not model accuracy: hair is treated as an unordered set of card tokens generated jointly with set diffusion, and the bones are generated by a chained diffusion model. What comes out is an asset artists and players can drop straight into their pipeline (cards + UVs + bones + VRM), not a blob mesh and not realistic strands. That is why it took off: the same author's CHARM was already close in research terms but its output was unusable, and it got only 60 stars. The metric gains (Chamfer -44%, 33x faster) were a bonus that almost nobody mentioned in the repost threads.

6. Visibility and copycats

  • Visibility: it spread within small circles. The Japanese 3DCG news post passed 20k views, the Bilibili bundle passed 20k plays, and ComfyUI wiki covered it. But it never reached HN, no large English AI accounts (hundreds of thousands of followers) reposted it, and our own X corpus (x-radar) found nothing. It's an open-source academic project, so there is no revenue.
  • Copycats: so far only wrappers, no clones (ComfyUI-HairDeck 2 stars, the Pinokio installer, the Bilibili bundle).
  • Opportunity: the downstream gap is obvious. Turn it into a VRoid, Blender, or Unity plugin, or a web SaaS "upload a character sheet → get a VRM hairstyle" that charges inside the BOOTH ecosystem. The Apache-2.0 license allows commercial use, but SAM 3 and DINOv3 are gated weights with their own licenses, which need separate review.

7. What others can learn

  • For an academic project to get stars: the output format targets an ecosystem of players who already pay (VRM, BOOTH), not just paper metrics.
  • Release cadence: code, weights, and the online demo drop the same day; then a platform or feature update every 1–2 days, each giving a fresh reason for secondary sharing.
  • Three-language README so the Chinese and Japanese anime news accounts repost it on their own.
  • Wait for someone else to build the ComfyUI or Pinokio wrapper, or build it yourself first.

8. Still unclear

  • How many people actually use it and whether it can really enter a VRChat production workflow: one YouTube test video is titled "I Tested the Space (and It Broke)"; local running needs CUDA, plus applying for gated SAM 3 / DINOv3 weights.
  • Full spread chain for the X post (whether a bigger Japanese account reposted it): not in the x-radar corpus, only a few single posts were captured.
  • Reddit is blocked, so unchecked. Whether r/VRchat and r/vroid discussed it: not verified.

Sources

This article was written by AI from public data and the data we collect daily. Numbers are sourced, and inferences are labeled.