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
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 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
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 for the full step-by-step installation guide with all pitfalls documented.