Hermes
c4057c261e
Documents all pitfalls encountered during setup: - CUDA arch mismatch (sm_120 vs sm_89) — source rebuild needed - utils3d empty pip package → GitHub fork required - transformers v5 DINOv3 API change → sed patch - xformers version pinning (0.0.33.post2 for torch 2.9.1) - Missing Eigen headers for cumesh build - visualbruno forks needed for o_voxel and cumesh (newer functions) - /tmp disk space issues during pip builds Includes: - SETUP.md: Full step-by-step guide - requirements.txt: Pinned dependency versions - fix_transformers_v5.sh: Apply DINOv3 layer patch - build_cuda_extensions.sh: One-shot source build of all CUDA extensions
49 lines
2.0 KiB
Markdown
49 lines
2.0 KiB
Markdown
# ComfyUI + Trellis2 on Rocky Linux 9.x / RTX 4090
|
|
|
|
**Working setup as of June 2026.** Documents every pitfall, fix, and the exact working configuration
|
|
for running [ComfyUI-Trellis2](https://github.com/visualbruno/ComfyUI-Trellis2) on Rocky Linux 9.7
|
|
with an NVIDIA RTX 4090 (sm_89 / Ada Lovelace).
|
|
|
|
## Quick Reference
|
|
|
|
| Component | Source | Build | Version |
|
|
|-----------|--------|-------|---------|
|
|
| CUDA Toolkit | DNF (`cuda-toolkit-12-8`) | system | 12.8 |
|
|
| PyTorch | pip `--index-url https://download.pytorch.org/whl/cu128` | prebuilt | 2.9.1+cu128 |
|
|
| flex_gemm | `JeffreyXiang/FlexGEMM` (GitHub) | **source (sm_89)** | 1.0.0 |
|
|
| o_voxel | `visualbruno/TRELLIS.2#subdirectory=o-voxel` | **source (sm_89)** | 0.0.1 |
|
|
| cumesh | `visualbruno/CuMesh` (GitHub) | **source (sm_89)** | 1.0 |
|
|
| nvdiffrast | `NVlabs/nvdiffrast` (GitHub) | **source (sm_89)** | 0.4.0 |
|
|
| xformers | pip `--index-url https://download.pytorch.org/whl/cu128` | prebuilt | 0.0.33.post2 |
|
|
| natten | `-f https://whl.natten.org` | prebuilt | 0.21.5+torch290cu128 |
|
|
| utils3d | `EasternJournalist/utils3d.git@3fab839` | source | 1.3 |
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
~/Documents/ComfyUI_trellis2_pixal/
|
|
├── venv/ # Python 3.12 virtual environment
|
|
├── main.py # ComfyUI entry point
|
|
├── custom_nodes/
|
|
│ └── ComfyUI-Trellis2/ # visualbruno/ComfyUI-Trellis2
|
|
├── models/
|
|
│ ├── facebook/
|
|
│ │ └── dinov3-vitl16-pretrain-lvd1689m/ # DINOv3 model (download manually)
|
|
│ └── trellis2/
|
|
│ └── TRELLIS.2-4B/ # TRELLIS.2-4B model (download manually)
|
|
└── conda-libs/ # Conda libstdc++ workaround (legacy)
|
|
```
|
|
|
|
## Start ComfyUI
|
|
|
|
```bash
|
|
cd ~/Documents/ComfyUI_trellis2_pixal
|
|
source venv/bin/activate
|
|
python main.py --listen 127.0.0.1
|
|
# GUI at http://127.0.0.1:8188
|
|
```
|
|
|
|
## Key Learnings
|
|
|
|
See [SETUP.md](SETUP.md) for the full step-by-step installation guide with all pitfalls documented.
|