Add native Hunyuan3D 2.1 PBR paint (mesh -> multiview -> textured GLB) - #15020

Open

jethac wants to merge 77 commits into

Comfy-Org:masterfrom

jethac:hunyuan21-paint

Commits on Aug 5, 2026

feat(hunyuan3d): add native 2.1 PBR paint UNet port and loader
jethac
committed
027c8b3
feat(hunyuan3d): add 2.1 paint multiview nodes
jethac
committed
13918bf
test(hunyuan3d): unit tests for 2.1 paint model, detection and sampler
jethac
committed
0cad4ab
feat(hunyuan3d): torch-native mesh rasterizer, geometry renderer and multiview baker
jethac
committed
f9bf88e
feat(save3d): support a metallic-roughness texture in the textured GLB path
jethac
committed
3538a37
feat(hunyuan3d): wire mesh rendering + multiview bake into the 2.1 paint nodes
jethac
committed
14761fc
test(hunyuan3d): renderer, UV unwrap, baker and textured-GLB write-back
jethac
committed
a74dd5c
fix(hunyuan3d): make the multiview baker device-robust; add end-to-end node test
jethac
committed
7575d49
fix(hunyuan3d): match Tencent's rasterizer pixel convention (y-flip)
jethac
committed
a6188d3
Clarify camera-matrix provenance comment in paint renderer
jethac
committed
10fa23f
Upgrade paint bake hole fill to gutter dilation plus push-pull inpaint
jethac
committed
988ec99
Test bake view weighting, cosine falloff and the two-stage hole fill
jethac
committed
fe8352e
Document external-UV bake targeting in Hunyuan3DBakeMultiView
jethac
committed
d8f4abe
Clarify paint module provenance and restate PoseRoPE helpers
jethac
committed
09265a2
Assert paint DDIM schedule parity with core model sampling
jethac
committed
eec1f2a
Add chirality-cube convention armor with mutation self-test
jethac
committed
397356d
Document renderer coordinate conventions
jethac
committed
f8b5ffb
Improve paint loader errors for wrong-family and truncated checkpoints
jethac
committed
9e34909
Validate renderer inputs and test GLB texture colorspace round-trip
jethac
committed
4a576e3
Add paint parity harness with tiny CI goldens
jethac
committed
7db47da
Make reference capture runnable in a slim CPU venv
jethac
committed
bc1eb87
Fix reference attention value packing to match trained weights
jethac
committed
e09cffc
Route paint attention through comfy optimized_attention
jethac
committed
99be586
Drive the paint model through core sampling and model management
jethac
committed
7a175c3
Address review: drop einops, no_grad wrappers; harden edge cases
jethac
committed
953618d
Fix CONVENTIONS.md scale wording (diameter, not radius); hoist test imports
jethac
committed
d7984c8
Assert nonzero bake coverage before MR channel checks
jethac
committed
64c1b9a
Append texture_mr to MESH rather than inserting it mid-signature
jethac
committed
6f56d77
Skip the metallic-roughness encode when there is no base texture
jethac
committed
536a1ee
Fail loudly on a mispacked paint latent instead of dropping per-view guidance
jethac
committed
4d76ec0
Make the paint test weight init reproducible; tidy the parity harness
jethac
committed
6e9e296
Allocate the learned material embeddings with torch.empty
jethac
committed
090a266
Find rasterizer chunk boundaries once instead of rescanning every face
jethac
committed
8320964
Bake albedo and metallic-roughness in a single pass
jethac
committed
fc132f8

Commits on Aug 30, 2026

Commits on Sep 6, 2026