Introduction
# 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