Skip to content

Commit 54441e0

Browse files
update for corrected system and memory details
1 parent dca0b65 commit 54441e0

File tree

2 files changed

+19
-38
lines changed

2 files changed

+19
-38
lines changed

troubleshooting/model-issues.mdx

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -107,18 +107,14 @@ If you have models in custom locations, see the detailed guide for [ComfyUI Mode
107107
**Symptoms:** Long delays when switching models or starting generation
108108

109109
**Solutions:**
110-
1. **Keep models in VRAM:**
111-
```bash
112-
python main.py --highvram
113-
```
114-
115-
2. **Use faster storage:**
110+
1. **Use faster storage:**
116111
- Move models to SSD if using HDD
117112
- Use NVMe SSD for best performance
118113

119-
3. **Adjust caching settings:**
114+
2. **Adjust caching settings:**
120115
```bash
121116
python main.py --cache-classic # Use the old style (aggressive) caching.
117+
python main.py --cache-lru 10 # Increase size of LRU cache
122118
```
123119

124120
### Memory Issues with Large Models

troubleshooting/overview.mdx

Lines changed: 16 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,10 @@ Before diving into detailed troubleshooting, try these common solutions:
4949

5050
For low VRAM systems:
5151
```bash
52-
# Low VRAM mode (splits model into parts)
52+
# Low VRAM mode (uses cpu for text encoder)
5353
python main.py --lowvram
5454

55-
# Even lower VRAM when --lowvram isn't enough
56-
python main.py --novram
57-
58-
# CPU mode (very slow but works with any hardware)
55+
# CPU mode (very slow but works with any hardware, only use as absolute last resort)
5956
python main.py --cpu
6057
```
6158

@@ -64,12 +61,6 @@ For better performance:
6461
# Disable previews (saves VRAM and processing)
6562
python main.py --preview-method none
6663

67-
# Keep models in VRAM (faster but uses more VRAM)
68-
python main.py --highvram
69-
70-
# Force FP16 precision (faster, uses less VRAM)
71-
python main.py --force-fp16
72-
7364
# Use optimized attention mechanisms
7465
python main.py --use-pytorch-cross-attention
7566
python main.py --use-flash-attention
@@ -87,8 +78,9 @@ python main.py --reserve-vram 2
8778
python main.py --disable-smart-memory
8879

8980
# Use different caching strategies
90-
python main.py --cache-none # Less RAM usage
91-
python main.py --cache-lru 10 # Cache 10 results
81+
python main.py --cache-none # Less RAM usage, but slower
82+
python main.py --cache-lru 10 # Cache 10 results, faster
83+
python main.py --cache-classic # Use the old style (aggressive) caching.
9284
```
9385

9486
## Installation-Specific Issues
@@ -108,15 +100,17 @@ python main.py --cache-lru 10 # Cache 10 results
108100
- **Crashes**: Check Console app for crash reports
109101
</Tab>
110102
<Tab title="Linux">
111-
- **Permission denied**: `chmod +x` the ComfyUI executable
112103
- **Missing libraries**: Install dependencies with package manager
113-
- **Display issues**: Set `export DISPLAY=:0` if using SSH
114104
- **LD_LIBRARY_PATH errors**: PyTorch library path issues (see below)
115105
</Tab>
116106
</Tabs>
117107

118108
### Manual Installation Issues
119109

110+
<Note>
111+
The documentation may be slightly out of date. If an issue occurs, please manually verify whether a newer stable version of pytorch or any of the listed libraries exists. Refer to resources like the [pytorch installation matrix](https://pytorch.org/get-started/locally/) or the [ROCm website](https://rocm.docs.amd.com/projects/install-on-linux/en/develop/install/3rd-party/pytorch-install.html#using-a-wheels-package).
112+
</Note>
113+
120114
**Python version conflicts:**
121115
```bash
122116
# Check Python version (3.9+ required, 3.12 recommended)
@@ -139,8 +133,8 @@ pip install -r requirements.txt
139133
# For NVIDIA GPUs (CUDA 12.8)
140134
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu128
141135

142-
# For AMD GPUs (Linux only - ROCm 6.2.4)
143-
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.2.4
136+
# For AMD GPUs (Linux only - ROCm 6.3)
137+
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.3
144138
```
145139

146140
### Linux-Specific Issues
@@ -291,11 +285,11 @@ nvidia-smi --query-gpu=driver_version --format=csv
291285

292286
**ROCm support (Linux only):**
293287
```bash
294-
# Install stable ROCm PyTorch (6.2.4)
295-
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.2.4
288+
# Install stable ROCm PyTorch (6.3.1 at the time of writing)
289+
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.3
296290

297-
# For nightly builds with ROCm 6.3 (might have performance improvements)
298-
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.3
291+
# For nightly builds (ROCm 6.4 at the time of writing), which might have performance improvements)
292+
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.4
299293
```
300294

301295
**Unsupported AMD GPUs:**
@@ -309,18 +303,13 @@ HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py
309303

310304
**Performance optimization:**
311305
```bash
312-
# Enable experimental memory efficient attention
306+
# Enable experimental memory efficient attention (no longer necessary with PyTorch 2.4)
313307
TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 python main.py --use-pytorch-cross-attention
314308

315309
# Enable tunable operations (slow first run, but faster subsequent runs)
316310
PYTORCH_TUNABLEOP_ENABLED=1 python main.py
317311
```
318312

319-
**DirectML (Windows):**
320-
```bash
321-
pip install torch-directml
322-
python main.py --directml
323-
```
324313

325314
### Apple Silicon (M1/M2/M3) Issues
326315

@@ -479,7 +468,3 @@ When reporting any issue, include:
479468
- **Discord:** [ComfyUI Discord Server](https://discord.com/invite/comfyorg)
480469
- **Reddit:** [r/comfyui](https://reddit.com/r/comfyui)
481470
- **YouTube:** [ComfyUI Tutorials](https://www.youtube.com/@comfyorg)
482-
483-
<Note>
484-
For urgent issues affecting many users, check our [status page](https://status.comfy.org) and [official Twitter](https://x.com/ComfyUI) for announcements.
485-
</Note>

0 commit comments

Comments
 (0)