comfyui-launch-flags

Featured

Pick the right ComfyUI startup flags for VRAM, attention, caching, and speed — the full decision matrix for OOM (--novram / --cache-none / --disable-smart-memory), shared-VRAM creep on Windows (--reserve-vram N), model-switching with big text encoders (--cache-none), high-VRAM throughput (--gpu-only / --highvram), and attention-backend selection (--use-sage-attention for speed, --use-pytorch-cross-attention as the highest-quality / Z-Image-safe fallback). Also the acceleration-stack + Blackwell/RTX 5000 (sm_120) notes. Use when a graph OOMs (especially long video like LTX 2 / WAN), when the GPU spills into shared VRAM and slows to a crawl, when switching between models eats all RAM, when Z-Image produces black/garbled output under Sage, or when deciding which attention backend to launch with. Flag names verified against upstream comfy/cli_args.py — see Sources.

AI & Automation 450 stars 76 forks Updated today MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
88
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# ComfyUI launch/performance flags ## Overview ComfyUI's runtime behavior is controlled by CLI flags passed to `main.py` (e.g. `python main.py --reserve-vram 2 --use-sage-attention`). The three that matter most for making a graph *run* — rather than OOM or crawl — are the **VRAM strategy**, the **attention backend**, and the **cache mode**. This skill is the decision matrix for choosing them. > ⚠️ **Verification note (June 2026).** Every flag below was checked against > upstream [`comfy/cli_args.py`](https://github.com/comfyanonymous/ComfyUI/blob/master/comfy/cli_args.py). > ComfyUI adds/renames flags often — when in doubt run `python main.py --help` > in the target install and prefer that over this list. One common non-upstream > flag: **`--enable-triton-backend` is a SwarmUI backend flag, NOT a ComfyUI > `main.py` flag** — don't pass it to ComfyUI directly. > ℹ️ **How to apply today.** The MCP's `start_comfyui` currently *replays the > exact argv of the previous run* — it does not compose fresh flags. So set > these when you launch ComfyUI yourself (the `python main.py …` line, a > `run.bat`/shell alias, or the SwarmUI backend args box), then `start_comfyui` > will preserve them on restart. (Injecting flags through the tool is a tracked > follow-up.) --- ## Decide first: which flag do you need? ``` Symptom ▶ Flag(s) to try ───────────────────────────────────────────────────────────────────────────── CUDA out of memory, long...

Details

Author
artokun
Repository
artokun/comfyui-mcp
Created
5 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category