Initial: ComfyUI + Trellis2 on Rocky 9.x / RTX 4090

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

README.md

@@ -1,3 +1,48 @@
-# comfyui-trellis2-rocky-setup
+# ComfyUI + Trellis2 on Rocky Linux 9.x / RTX 4090
 
-ComfyUI + Trellis2 on Rocky Linux 9.x / RTX 4090 — all pitfalls, fixes, working config
+**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.