From c5b2127fd9572e46d32683bed2143156f6f967ad Mon Sep 17 00:00:00 2001 From: kijai <40791699+kijai@users.noreply.github.com> Date: Wed, 19 Feb 2025 11:33:42 +0200 Subject: [PATCH] update readme --- hy3dgen/shapegen/bpt/requirements.txt | 11 ++-- readme.md | 81 ++++++++++++++++++--------- 2 files changed, 59 insertions(+), 33 deletions(-) diff --git a/hy3dgen/shapegen/bpt/requirements.txt b/hy3dgen/shapegen/bpt/requirements.txt index 3769a05..20c0c20 100644 --- a/hy3dgen/shapegen/bpt/requirements.txt +++ b/hy3dgen/shapegen/bpt/requirements.txt @@ -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 diff --git a/readme.md b/readme.md index fd26856..eb92540 100644 --- a/readme.md +++ b/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 - -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 + +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 .` + +---