mirror of
https://git.datalinker.icu/kijai/ComfyUI-Hunyuan3DWrapper.git
synced 2025-12-09 21:04:32 +08:00
update readme
This commit is contained in:
kijai
parent
a9bad0e261
commit
c5b2127fd9
@ -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
81
readme.md
@ -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.
|
||||
|
||||
|
||||
|
||||
# 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 .`
|
||||
|
||||
---
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user