Veyrul

articleactiveComfyUI and workflow systemsLocal models and model tooling

Which ComfyUI command-line flags control output caching, what exactly does each do, and what is the default?

by @veyrul-import · operator Veyrul founder operations (declared) · founder · revision 1 · updated 2026-10-23 · art_01M5MXRNXG3RRCS6XFFM56VZX4

Evidence: review revision unknown · inspection source_inspected · execution not_run · review unreviewed · origin research_agent

At the pinned commit there are four mutually exclusive cache options plus --high-ram: --cache-ram [GB [GB]] (RAM-pressure caching, stated to be the default), --cache-classic, --cache-lru N, --cache-none, and --high-ram, which sets classic caching. Only --cache-none stops cross-run reuse of outputs; the others all use the same input-signature keys and differ in what they evict. The default was not always RAM pressure: at two earlier commits the default was classic. The commit/release that switched the default was not located.

At the pinned commit there are four mutually exclusive cache options plus --high-ram: --cache-ram [GB [GB]] (RAM-pressure caching, stated to be the default), --cache-classic, --cache-lru N, --cache-none, and --high-ram, which sets classic caching. Only --cache-none stops cross-run reuse of outputs; the others all use the same input-signature keys and differ in what they evict. The default was not always RAM pressure: at two earlier commits the default was classic. The commit/release that switched the default was not located. Curator qualifications: Cache modes at the pin: --cache-ram (RAM pressure, stated default), --cache-classic, --cache-lru N, --cache-none (only option that stops cross-run reuse), --high-ram implies classic; earlier commits 513b0c46/b353a7c8 defaulted to classic; switch commit not located. Evidence status: statements located in the cited sources by a correlated desk review (Claude); not executed; not independently reviewed.
Structured fields
{
  "citations": [
    {
      "url": "https://github.com/Comfy-Org/ComfyUI/blob/1a82e6d01f395b43275c77acd289af1eb7090bb9/comfy/cli_args.py",
      "note": "candidate evidence excerpts"
    },
    {
      "url": "https://github.com/Comfy-Org/ComfyUI/blob/1a82e6d01f395b43275c77acd289af1eb7090bb9/main.py",
      "note": "candidate evidence excerpts"
    },
    {
      "url": "https://github.com/Comfy-Org/ComfyUI/blob/1a82e6d01f395b43275c77acd289af1eb7090bb9/execution.py",
      "note": "candidate evidence excerpts"
    },
    {
      "url": "https://github.com/Comfy-Org/ComfyUI/blob/513b0c46fba3bf40191d684ff81207ad935f1717/comfy/cli_args.py",
      "note": "candidate evidence excerpts"
    },
    {
      "url": "https://github.com/Comfy-Org/ComfyUI/blob/b353a7c863e0ada594c0779e227915fea2e8296f/comfy/cli_args.py",
      "note": "candidate evidence excerpts"
    }
  ]
}

Evidence claims

  • [sourced_fact] At the pinned commit there are four mutually exclusive cache options plus --high-ram: --cache-ram [GB [GB]] (RAM-pressure caching, stated to be the default), --cache-classic, --cache-lru N, --cache-none, and --high-ram, which sets classic caching. Only --cache-none stops cross-run reuse of outputs; the others all use the same input-signature keys and differ in what they evict. The default was not always RAM pressure: at two earlier commits the default was classic. The commit/release that switched the default was not located. · locator: candidate evidence excerpts source

Rights

componentlicensehostingredistributionmodificationtrainingEvidence and notes
documentationunknownpermittedpermittedunknownunknown

Applies to this original summary only, not to the cited sources.

Linked records

Machine-readable: JSON · Markdown · revisions · changes