Hunyuan3D-2.1 image-to-3D with Hermite velocity cache
Hunyuan3D-2.1 (© Tencent) generates a textured 3D asset from a single image (or text): a DiT flow-matching sampler denoises a latent shape, then a paint stage textures it. This fork adds HiCache to that loop, forecasting the cached velocity on skipped steps instead of running the DiT.
git clone https://github.com/Archerkattri/hunyuan2.1-plus.git
cd hunyuan2.1-plus
pip install -r requirements.txt
# weights are not committed — download from Tencent-Hunyuan/Hunyuan3D-2.1 per its instructions
01
Evidence
| Historical quality, interval-3 | 0.88 F-score@0.05 on Toys4K (3-seed), ~1.7× faster — Hermite reference arm, historical |
|---|---|
| Historical quality, interval-5 | 0.74 vs uncached 0.91 — polynomial output drops as the skip grows, historical |
| Benchmark protocol | Toys4K, F-score@0.05, 3 seeds; no current-commit model or GPU A/B was run in this packet |
| CPU contract tests | 4 pass — cache identity, schedule traces, reset/CFG formula, adaptive-CFG index |
| Example cache schedule | interval 3, max_order 1, first_enhance 2, sigma 0.5 — one DiT forward, then forecasts |
| Skip fraction | skips (interval−1)/interval of DiT forwards; with fewer than 2 anchors the forecast reuses the cached velocity |
02
Media
03
Install & verify
python -m pytest tests/ -q # expect 4 passed — four CPU contract tests python -m hy3dshape.hy3dshape.hicache # expect "hunyuan2.1-plus Hermite smoke passed" — CPU only, no GPU or model
04
Limits
What this release does not claim (from the release notes):
- GPU speedup validation and weight-gated demo cells — not verified in this release (no GPU hardware).
05
Family
| Base model | Hunyuan3D-2.1, accelerated by the hicache-plus-plus forecast core |
|---|---|
| Same base | hunyuan2.1-plus-plus |
| All 13 adapters | TRELLIS: faster-trellis, faster-trellis-plus-plus · TRELLIS.2: fast-trellis2, hermit-trellis2, hermit-trellis2-plus-plus · Hunyuan3D-2: hunyuan2-plus, hunyuan2-plus-plus · Hunyuan3D-2.1: hunyuan2.1-plus, hunyuan2.1-plus-plus · SAM: sam3d-plus, sam3d-plus-plus, fastsam3d-plus, fastsam3d-plus-plus |
| External | Paper arXiv:2506.15442 |