comfy-cli

# comfy-cli CLI tool for managing ComfyUI installations, custom nodes, and models. ## Quick start ```bash 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 ```bash 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 version ``` GPU 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 ```bash 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 PR ``` ## Workspace selection Global flags (mutually exclusive): ```bash 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 default ``` ## Custom nodes ```bash 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 dependencies ``` Snapshots: ```bash 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 nodes ``` Debugging: ```bash 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 deps ``` Publishing: ```bash 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 registry ``` ## Models ```bash comfy model list # List available models comfy model download --url <url> # Download from URL comfy model remove <name> # Remove model ``` Sources: CivitAI, Hugging Face, direct URLs Tokens for gated models: - `--civitai-token` or config `civitai_api_token` - `--hf-token` or config `hf_api_token` ## Run workflows ```bash comfy run --workflow workflow_api.json comfy run --workflow workflow.json --wait --verbose comfy run --workflow workflow.json --host 192.168.1.10 --port 8188 ``` Requires running ComfyUI instance. ## ComfyUI-Manager ```bash comfy manager disable-gui # Hide manager in UI comfy manager enable-gui # Show manager in UI comfy manager clear # Clear startup actions ``` ## Update ```bash comfy update all # Update ComfyUI + nodes comfy update comfy # Update ComfyUI only ``` ## Other commands ```bash 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 feedback ``` ## Config 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-prompt` for non-interactive mode (CI/scripts) - Background mode tracks PID for clean `comfy stop` - Snapshots preserve exact node versions for reproducibility - `comfy node bisect` binary-searches to find which node broke your setup - PR cache avoids rebuilding frontend PRs you've tested before