# 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.