xinyun/ComfyUI-Hunyuan3DWrapper
1
0
Fork 0
mirror of https://git.datalinker.icu/kijai/ComfyUI-Hunyuan3DWrapper.git synced 2025-12-09 12:54:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

update readme

Browse Source
This commit is contained in:
kijai 2025-02-19 11:33:42 +02:00
parent a9bad0e261
commit c5b2127fd9
2 changed files with 59 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
hy3dgen/shapegen/bpt/requirements.txt
View File

@ -1,15 +1,15 @@
meshgpt_pytorch==0.6.7
pytorch-custom-utils==0.0.21
meshgpt_pytorch>=0.6.7
pytorch-custom-utils>=0.0.21
accelerate>=0.25.0
beartype
classifier-free-guidance-pytorch==0.5.1
classifier-free-guidance-pytorch>=0.5.1
einops>=0.7.0
ema-pytorch
pytorch-warmup
torch_geometric
torchtyping
vector-quantize-pytorch==1.12.8
x-transformers==1.26.6
vector-quantize-pytorch>=1.12.8
x-transformers>=1.26.6
tqdm
matplotlib
wandb
@ -20,7 +20,6 @@ pyrender
open3d-python
easydict
chardet
deepspeed
omegaconf
scikit-image
setuptools

81
readme.md
View File

@ -1,30 +1,8 @@
# Added BPT
`cd ComfyUI-Hunyuan3DWrapper-main\hy3dgen\shapegen\bpt`
`python_embeded\python.exe -m pip install -r requirements.txt`
Download weights <https://huggingface.co/whaohan/bpt/blob/refs%2Fpr%2F1/bpt-8-16-500m.pt>
Copy `bpt-8-16-500m.pt` to `ComfyUI-Hunyuan3DWrapper-main\hy3dgen\shapegen\bpt`
# Xatlas Upgrade procedure
`python_embeded\python.exe -m pip uninstall xatlas`
`git clone --recursive https://github.com/mworchel/xatlas-python.git`
`cd .\xatlas-python\`
copy `https://github.com/mworchel/xatlas-python.git` into `xatlas-python\extern\xatlas` and back to `xatlas_python`
`..\python_embeded\python.exe setup.py install`
`..\python_embeded\python.exe -m pip install .`
# ComfyUI wrapper for [Hunyuan3D-2](https://github.com/Tencent/Hunyuan3D-2)
---
# WORK IN PROGRESS
# installation still messy, may require compiling for texture gen
## Models
Main model, original: https://huggingface.co/tencent/Hunyuan3D-2/blob/main/hunyuan3d-dit-v2-0/model.ckpt
Converted to .safetensors: https://huggingface.co/Kijai/Hunyuan3D-2_safetensors
@ -32,6 +10,7 @@ Converted to .safetensors: https://huggingface.co/Kijai/Hunyuan3D-2_safetensors
to `ComfyUI/models/diffusion_models/`
Rest of the models are diffusers models, so they are wrapped and autodownloaded for now. Very new version of ComyUI is also required for the Preview3D -node.
---
# Installation
Dependencies, in your python env:
@ -57,17 +36,29 @@ Current latest portable was updated to use pytorch 2.6.0, for this you should us
`python_embeded\python.exe -m pip install ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\wheels\custom_rasterizer-0.1.0+torch260.cuda126-cp312-cp312-win_amd64.whl`
This was tested to work on latest ComfyUI portable install
---
If this doesn't work, you need to compile yourself:
## If this doesn't work or there isn't a suitable wheel available for your system. you need to compile yourself:
Rasterizer, to build and install:
```
cd hy3dgen/texgen/custom_rasterizer
python_embeded\python.exe setup.py install
python_embeded\python.exe -m pip install .
python setup.py install
```
**If you are using the portable ComfyUI installation:**
For example (check the paths on your system):
```
cd C:\ComfyUI_windows_portable\ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\hy3dgen\texgen\custom_rasterizer
C:\ComfyUI_windows_portable\python_embeded\python.exe -m pip install .
```
If you get an error about Python.h missing, refer to the instructions here as it's the same compilation issue (you don't need Triton itself):
https://github.com/woct0rdho/triton-windows?tab=readme-ov-file#8-special-notes-for-comfyui-with-embeded-python
Or build with `python setup.py bdist_wheel` which creates the .whl file to the dist -subfolder, which you then would pip install to your python environment.
End result needs to be `custom_rasterizer_kernel*.pyd` file and `custom_rasterizer` folder in your python environments `site-packages` folder.
@ -81,3 +72,39 @@ This file is supposed to be in that very folder. It is only used for the vertex
Again, with portable you should use the embedded python to run the commands.
![alt text](example_workflows/example_workflow.png)
# Update:
## Added BPT
**This has some hefty requirements, fully optional, install at your own discretion**
```
cd ComfyUI-Hunyuan3DWrapper\hy3dgen\shapegen\bpt
pip install -r requirements.txt
```
## Installation with portable ComfyUI:
from the portable's root directory:
`python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\hy3dgen\shapegen\bpt\requirements.txt`
Download weights <https://huggingface.co/whaohan/bpt/blob/refs%2Fpr%2F1/bpt-8-16-500m.pt>
Copy `bpt-8-16-500m.pt` to `ComfyUI-Hunyuan3DWrapper-main\hy3dgen\shapegen\bpt`
# Xatlas upgrade procedure to fix UV wrapping high poly meshes
`python_embeded\python.exe -m pip uninstall xatlas`
in the portable root folder:
`git clone --recursive https://github.com/mworchel/xatlas-python.git`
`cd .\xatlas-python\`
copy `https://github.com/mworchel/xatlas-python.git` into `xatlas-python\extern\xatlas` and back to `xatlas_python`
`..\python_embeded\python.exe setup.py install`
`..\python_embeded\python.exe -m pip install .`
---