update readme

hy3dgen/shapegen/bpt/requirements.txt

@@ -1,15 +1,15 @@
-meshgpt_pytorch==0.6.7
+meshgpt_pytorch>=0.6.7
-pytorch-custom-utils==0.0.21
+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
+vector-quantize-pytorch>=1.12.8
-x-transformers==1.26.6
+x-transformers>=1.26.6
 tqdm
 matplotlib
 wandb
@@ -20,7 +20,6 @@ pyrender
 open3d-python
 easydict
 chardet
-deepspeed
 omegaconf
 scikit-image
 setuptools

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
+## Models
-# installation still messy, may require compiling for texture gen
-
 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 setup.py install
-python_embeded\python.exe -m pip 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 .`
+
+---