Skip to main content
This guide covers frequently encountered issues and their solutions when running ComfyUI.

​
Installation Issues

This error occurs when PyTorch is installed without CUDA support.Solution:
  1. Uninstall the current PyTorch installation:
  2. Reinstall PyTorch with CUDA support:
For AMD GPUs, use the ROCm version instead:
If you have trouble extracting the portable Windows version, the file may be blocked by Windows.Solution:
  1. Right-click the downloaded .7z file
  2. Select Properties
  3. Check the Unblock checkbox at the bottom
  4. Click OK and try extracting again
Custom nodes can sometimes conflict or fail to load properly.Solution:Disable all custom nodes to isolate the issue:
To enable only specific nodes:
This helps identify which custom node is causing problems.

​
Memory Issues

OOM errors occur when your GPU runs out of VRAM during generation.Solution:Use low VRAM mode to reduce memory usage:
For extremely limited VRAM (< 2GB):
For systems without a GPU:
Note: CPU mode is significantly slower than GPU mode.
A known bug in xformers version 0.0.18 causes black images when generating high-resolution outputs.Solution:Downgrade or upgrade xformers to a different version:
Or disable xformers entirely:
If you see a warning about cudaMallocAsync compatibility with your GPU.Solution:Disable CUDA malloc:
This is particularly relevant for older GPUs that don’t support async memory allocation.

​
Runtime Errors

ComfyUI can’t find your checkpoint files.Solution:
  1. Ensure models are in the correct directory:
    • Checkpoints: models/checkpoints
    • VAE: models/vae
    • LoRAs: models/loras
    • Embeddings: models/embeddings
  2. Configure extra model paths by copying extra_model_paths.yaml.example to extra_model_paths.yaml and editing it:
  3. Edit extra_model_paths.yaml with your model paths
  4. Restart ComfyUI
Latent previews may not be enabled or TAESD models are missing.Solution:
  1. Enable preview method:
  2. For high-quality previews, download TAESD decoder files:
    • taesd_decoder.pth
    • taesdxl_decoder.pth
    • taesd3_decoder.pth
    • taef1_decoder.pth
  3. Place them in models/vae_approx directory
  4. Launch with TAESD preview:
The execution may be stuck or waiting for resources.Solution:
  1. Check if a node has invalid inputs or missing connections
  2. Cancel the current execution with Ctrl + Alt + Enter
  3. If the issue persists, restart ComfyUI
  4. Check the console for error messages
Note: Only parts of the graph with all correct inputs will execute. Incomplete workflows will not run.

​
Platform-Specific Issues

macOS versions 14.5 and later have a known bug causing black images.Solution:Force upcast attention (automatically enabled on macOS 14.5+):
This forces computations to use higher precision, avoiding the black image bug.
Windows reserves additional VRAM for shared memory management.Solution:ComfyUI automatically reserves 600MB on Windows (vs 400MB on Linux). If you still experience issues:
This reserves 1GB of VRAM for the system. Adjust the value based on your needs.
AMD GPUs may need specific environment variables or settings.Solution:For unsupported AMD cards, override the architecture version:RDNA2 (6700, 6600):
RDNA3 (7600):
Enable experimental memory efficient attention:
Enable TunableOp (slow first run, faster subsequent runs):

​
Database and Assets

The asset database may fail to initialize if dependencies are missing.Solution:
  1. Ensure all requirements are installed:
  2. If the error persists, disable automatic asset scanning:
  3. Report persistent database issues as they may indicate a dependency problem

​
Getting Help

If you’ve tried the solutions above and still have issues:
  1. Discord: Join the ComfyUI Discord and try the #help or #feedback channels
  2. Matrix: Join the ComfyUI Matrix space at #comfyui_space:matrix.org
  3. GitHub Issues: Report bugs at the ComfyUI GitHub repository
When reporting issues, include:
  • Your operating system
  • GPU model and VRAM
  • Python version
  • PyTorch version
  • The full error message from the console
  • Steps to reproduce the issue