- name
- comfy-cli
- description
- Install, manage, and run ComfyUI instances. Use when setting up ComfyUI, launching servers, installing/updating/debugging custom nodes, downloading models from CivitAI/HuggingFace, managing workspaces, running API workflows, or troubleshooting node conflicts with bisect.
- metadata
- {"clawdbot":{"emoji":"🎨","requires":{"bins":["comfy"]},"install":[{"id":"uv","kind":"uv","package":"comfy-cli","bins":["comfy"],"label":"Install comfy-cli (uv)"}]}}
comfy-cli
CLI tool for managing ComfyUI installations, custom nodes, and models.
Quick start
comfy install # Install ComfyUI + ComfyUI-Manager
comfy launch # Start ComfyUI server
comfy node install ComfyUI-Impact-Pack # Install a custom node
comfy model download --url "https://civitai.com/api/download/models/12345"Installation
comfy install # Interactive GPU selection
comfy install --nvidia # NVIDIA GPU
comfy install --amd # AMD GPU (Linux ROCm)
comfy install --m-series # Apple Silicon
comfy install --cpu # CPU only
comfy install --restore # Restore deps for existing install
comfy install --pr 1234 # Install specific PR
comfy install --version latest # Latest stable release
comfy install --version 0.2.0 # Specific versionGPU options: --nvidia, --amd, --intel-arc, --m-series, --cpu
CUDA versions (NVIDIA): --cuda 12.9, --cuda 12.6, --cuda 12.4, --cuda 12.1, --cuda 11.8
Other flags: --skip-manager, --skip-torch-or-directml, --skip-requirement, --fast-deps
Launch
comfy launch # Foreground mode
comfy launch --background # Background mode
comfy launch -- --listen 0.0.0.0 # Pass args to ComfyUI
comfy stop # Stop background instance
comfy launch --frontend-pr 1234 # Test frontend PRWorkspace selection
Global flags (mutually exclusive):
comfy --workspace /path/to/ComfyUI ... # Explicit path
comfy --recent ... # Last used instance
comfy --here ... # Current directory
comfy which # Show selected instance
comfy set-default /path/to/ComfyUI # Set defaultCustom nodes
comfy node show # List installed nodes
comfy node simple-show # Compact list
comfy node install <name> # Install from registry
comfy node install <name> --fast-deps # Fast dependency install
comfy node reinstall <name> # Reinstall node
comfy node uninstall <name> # Remove node
comfy node update all # Update all nodes
comfy node disable <name> # Disable node
comfy node enable <name> # Enable node
comfy node fix <name> # Fix node dependenciesSnapshots:
comfy node save-snapshot # Save current state
comfy node save-snapshot --output snapshot.json
comfy node restore-snapshot snapshot.json
comfy node restore-dependencies # Restore deps from nodesDebugging:
comfy node bisect # Binary search for broken node
comfy node deps-in-workflow workflow.json # Extract deps from workflow
comfy node install-deps --workflow workflow.json # Install workflow depsPublishing:
comfy node init # Init scaffolding
comfy node scaffold # Create project via cookiecutter
comfy node validate # Validate before publishing
comfy node pack # Package node
comfy node publish # Publish to registryModels
comfy model list # List available models
comfy model download --url <url> # Download from URL
comfy model remove <name> # Remove modelSources: CivitAI, Hugging Face, direct URLs
Tokens for gated models:
--civitai-tokenor configcivitai_api_token--hf-tokenor confighf_api_token
Run workflows
comfy run --workflow workflow_api.json
comfy run --workflow workflow.json --wait --verbose
comfy run --workflow workflow.json --host 192.168.1.10 --port 8188Requires running ComfyUI instance.
ComfyUI-Manager
comfy manager disable-gui # Hide manager in UI
comfy manager enable-gui # Show manager in UI
comfy manager clear # Clear startup actionsUpdate
comfy update all # Update ComfyUI + nodes
comfy update comfy # Update ComfyUI onlyOther commands
comfy env # Show config and paths
comfy --version # Print CLI version
comfy pr-cache list # List cached PR builds
comfy pr-cache clean # Clear expired caches
comfy standalone # Create standalone Python bundle
comfy tracking enable|disable # Manage analytics
comfy feedback # Submit feedbackConfig
Location:
- Linux:
~/.config/comfy-cli/config.ini - macOS:
~/Library/Application Support/comfy-cli/config.ini - Windows:
%APPDATA%\Local\comfy-cli\config.ini
Keys: default_workspace, default_launch_extras, civitai_api_token, hf_api_token
Tips
--skip-promptfor non-interactive mode (CI/scripts)- Background mode tracks PID for clean
comfy stop - Snapshots preserve exact node versions for reproducibility
comfy node bisectbinary-searches to find which node broke your setup- PR cache avoids rebuilding frontend PRs you've tested before