Instructions to use t8star/Hi3d-Comfy with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use t8star/Hi3d-Comfy with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("t8star/Hi3d-Comfy", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - Notebooks
- Google Colab
- Kaggle
Hi3D T8 — Core and Workbench Models
English | 简体中文
By T8star. Verified redistribution of the shared Hi3D core and all model components supported by the standalone Hi3D T8 workbench. Original weights, configurations, pinned revisions and individual licenses are retained. UltraTex uses an upstream-published fp8 base; this project did not quantize it.
ComfyUI only uses the Hi3D core for reference-image + coarse-mesh geometry refinement. Image-to-3D and PBR extensions belong to the standalone workbench. This model repository contains neither the application nor Python. GitHub Releases contain code only; T8star will provide the complete package with Python and models separately.
Included models
| Directories | Purpose | License |
|---|---|---|
hi3d/ |
Hi3D V1.0 geometry refinement; 512 and 1024 checkpoints, shared VAE; 1536 uses 1024 weights | Hi3D Open License v1.0 |
dino/, clip/ |
Required DINOv2 Large and CLIP ViT-L/14 core encoders | Apache-2.0 / MIT |
extensions/coarse/ |
Hunyuan3D-2mini Turbo image-to-geometry | Tencent Hunyuan 3D 2.0 Community |
extensions/coarse_hunyuan21/ |
Hunyuan3D 2.1 image-to-geometry | Tencent Hunyuan 3D 2.1 Community |
extensions/coarse_trellis2/, extensions/trellis_structure/ |
TRELLIS.2 geometry and structure decoder | MIT |
extensions/texture/, extensions/texture_encoder/ |
TRELLIS.2 PBR and DINOv3 encoder | MIT / DINOv3 License |
extensions/texture_hunyuan21/, extensions/paint_dino/, extensions/paint_upscaler/ |
Hunyuan3D-Paint 2.1, DINOv2 Giant and Real-ESRGAN | Tencent / Apache-2.0 / BSD-3-Clause |
extensions/texture_ultratex/, extensions/ultratex_backbone/, extensions/ultratex_text_encoder/ |
UltraTex adapters/decoder, FLUX.2 Klein 9B fp8, Qwen3 and VAE | MIT / FLUX Non-Commercial / Apache-2.0 |
extensions/background/ |
Optional CPU U2Netp foreground extraction | MIT / Apache-2.0 |
manifest.json records the shared core. extensions/manifest.json records 13 extension components, original repositories and fixed revisions. model-catalogue.json lists all 94 model/config/license artifacts (69.9GB) with byte counts and SHA256. ComfyUI and the workbench use identical Hi3D weights; no separate ComfyUI checkpoint exists.
Download
Run from the workbench root, not ComfyUI/models.
Core only, sufficient for the Hi3D ComfyUI integration:
hf download t8star/Hi3d-Comfy --local-dir models --include "manifest.json" "hi3d/*" "dino/*" "clip/*" "licenses/*"
All core and extension files (about 69.9GB; allow additional runtime and working space):
hf download t8star/Hi3d-Comfy --local-dir models
For selected engines, download the corresponding directories from the table plus extensions/manifest.json and their dependencies. The workbench's Models page can also download only the required engine components from pinned original/public sources. Missing optional engines do not disable installed ones. Verify files in the workbench before inference.
Program updates
The standalone bundle checks stable GitHub Releases, downloads code updates and installs them on the next launch. Models, Python runtimes, configuration and history are preserved. Code updates do not download this entire model repository. Runtime-incompatible versions require a new complete package. Update instructions.
Validation and limits
Real model runs were tested on Windows / RTX 5090 Laptop 24GB / 64GB RAM. Smaller GPUs have not been validated. Hi3D refinement is optional, rebuilds topology and does not generate textures; the separate PBR stage exports embedded-material GLB. Geometry, back views, UV seams and materials require inspection; printability and universal quality improvements are not guaranteed. Engine evidence.
Licenses
Each component retains its own license and attribution; no single MIT license covers the collection. Hi3D's LICENSE/NOTICE/AUTHORS are retained. DINOv3 retains the Meta agreement. UltraTex's FLUX.2 Klein 9B base uses the FLUX Non-Commercial License. See component directories, licenses/ and the source manifests. Powered by Hi3D 1.0.
T8star
Bilibili · YouTube · API · Free Gallery · Online AI Apps · ComfyUI Distribution · Hugging Face
- Downloads last month
- -