hunyuan3d-mlx-paint-small
Texture-paint weights for the small (RGB) paint slot of the Hunyuan3D-Swift / Modelr MLX pipeline.
This bundle is the official hunyuan3d-paint-v2-0 texture pipeline (Stable Diffusion 2.1 based multiview UNet with multi-attention / reference-attention, RGB color output) from Tencent's Hunyuan3D-2, plus the Real-ESRGAN ×4 upscaler used for the multiview super-resolution step. The tensor data is repackaged unmodified; only the on-disk layout is fixed so the byte layout is a stable contract for the MLX loader. The bundle is self-contained: the VAE and upscaler are included directly rather than cross-referenced from another repo.
Contents
| Path | Size | Description |
|---|---|---|
unet/config.json | 911 B | Multiview UNet configuration |
unet/diffusion_pytorch_model.safetensors | 3.66 GB | Multiview UNet weights |
vae/config.json | 553 B | VAE configuration |
vae/diffusion_pytorch_model.safetensors | 167.3 MB | VAE weights |
realesrgan/rrdbnet_mlx.safetensors | 66.9 MB | Real-ESRGAN RRDBNet ×4 upscaler (MLX-format safetensors) |
Total: 3.90 GB (3,896,831,131 bytes).
Usage
Consumed by the hy3d CLI from the Hunyuan3D-Swift package. Paint operates on an existing shape mesh plus the reference image (point --weights at the downloaded repo directory):
# 1. generate a shape (see hunyuan3d-mlx-shape-* bundles)
hy3d shape penguin.png -o mesh.glb --weights ./hunyuan3d-mlx-shape-small
# 2. paint it
hy3d paint mesh.glb penguin.png -o painted.glb --weights ./hunyuan3d-mlx-paint-small
Provenance
- Multiview UNet + VAE:
hunyuan3d-paint-v2-0— Tencent Hunyuan3D-2. - Upscaler: Real-ESRGAN (RRDBNet ×4).
License
- Paint UNet and VAE weights: Tencent Hunyuan3D-2 Community License — see https://huggingface.co/tencent/Hunyuan3D-2 and the license text.
- Real-ESRGAN (
realesrgan/rrdbnet_mlx.safetensors): BSD 3-Clause License (upstream xinntao/Real-ESRGAN).
Your use of each component is subject to its respective license.