Полное руководство пользователя Comfy CLI

Comfy CLI: это официальный инструмент командной строки для ComfyUI. Он позволяет устанавливать, управлять узлами и моделями, запускать рабочие процессы и вызывать партнёрские модели изображений/видео. Всё это делается из вашего терминала.

ℹ️ Примечание об обновлениях: Актуальную справку по CLI см. в официальном README или на docs.comfy.org.

Требования

Python 3.10+

Установка

Рекомендуемый способ: через pip

pip install comfy-cli

С помощью pipx (изолированное окружение)

pipx install comfy-cli

С помощью uv (быстрый установщик пакетов Python)

uv tool install comfy-cli

Автодополнение в оболочке

comfy --install-completion

Теперь comfy <TAB> раскрывает команды и опции.

Быстрый старт

# Запуск интерактивного мастера установки
comfy setup

comfy setup проведет вас через всё: локальную или облачную маршрутизацию, аутентификацию и установку навыков агентов — в одном интерактивном мастере. Используйте -y для неинтерактивной установки (CI/скрипты).

Также можно установить явно:

comfy install

Затем запустить:

comfy launch

## Управление рабочими пространствами

Comfy CLI поддерживает управление несколькими рабочими пространствами ComfyUI, позволяя вам одновременно поддерживать различные среды ComfyUI.

### Основные операции с рабочими пространствами

```bash
# Проверить путь текущего рабочего пространства
comfy which

# Установить рабочее пространство по умолчанию
comfy set-default /путь/к/вашему/рабочему/пространству

# Установить рабочее пространство по умолчанию с параметрами запуска
comfy set-default /путь/к/вашему/рабочему/пространству --launch-extras="--listen 0.0.0.0 --port 8080"

Выполнение команд в разных рабочих пространствах

Опция	Случай использования
`--workspace=<путь>`	Запуск из ComfyUI, установленного в указанном рабочем пространстве
`--recent`	Запуск из последнего использованного ComfyUI
`--here`	Запуск из ComfyUI в текущей директории

# Запустить ComfyUI в указанном рабочем пространстве
comfy --workspace=~/projects/project-a launch

# Установить узлы в последнем рабочем пространстве
comfy --recent node install ComfyUI-Impact-Pack

# Проверить, есть ли ComfyUI в текущей директории
comfy --here which

Примечание: --workspace, --recent и --here нельзя использовать вместе.

Правила приоритета рабочих пространств

Если рабочее пространство не указано:

Путь по умолчанию, заданный командой comfy set-default <путь>
Последний запущенный или установленный ComfyUI
ComfyUI в текущей директории

Параметры запуска

Базовый запуск

# Запуск по умолчанию
comfy launch

# Запуск в фоне
comfy launch --background

# Остановка фонового экземпляра
comfy stop

# Запуск с дополнительными аргументами
comfy launch -- --cpu --listen 0.0.0.0

Сетевые настройки

comfy launch -- --listen 0.0.0.0 --port 8080

Параметры производительности

comfy launch -- --cpu       # Режим только CPU
comfy launch -- --lowvram   # Режим низкой видеопамяти
comfy launch -- --novram     # Режим сверхнизкой видеопамяти

Тестирование pull request'ов

# Установка определённого PR ComfyUI
comfy install --pr "#1234"
comfy install --pr "https://github.com/comfyanonymous/ComfyUI/pull/1234"

# Тестирование PR фронтенда
comfy launch --frontend-pr "#456"
comfy launch --frontend-pr "username:branch-name"

Сборки PR фронтенда кешируются для быстрого переключения. Управление кешем:

comfy pr-cache list              # Список закешированных сборок PR
comfy pr-cache clean             # Очистка всех закешированных сборок
comfy pr-cache clean 456         # Очистка кеша конкретного PR

## Управление пользовательскими узлами

### Просмотр информации об узлах

```bash
comfy node show all                               # Все доступные узлы
comfy node simple-show installed                  # Простой список установленных узлов
comfy node show enabled                           # Только включенные узлы
comfy node show not-installed                     # Не установленные узлы
comfy node show disabled                          # Отключенные узлы
comfy node show all --channel recent              # Узлы из недавнего канала
comfy node show snapshot                          # Просмотр текущей информации о снимке
comfy node show snapshot-list                     # Список сохраненных снимков

Установка и обновление узлов

comfy node install ComfyUI-Impact-Pack            # Установить пользовательский узел
comfy node update all                             # Обновить все узлы
comfy node update ComfyUI-Impact-Pack             # Обновить конкретный узел

Быстрое разрешение зависимостей

Comfy CLI предлагает два способа использования uv для более быстрого разрешения зависимостей:

Функция	`--fast-deps`	`--uv-compile`
Область применения	`comfy install`, установка/переустановка узлов	Только команды пользовательских узлов
Метод разрешения	Встроенный в comfy-cli	Единый метод ComfyUI-Manager v4.1+
Обработка конфликтов	Интерактивный запрос	Автоматический с указанием узла

# Быстрая первоначальная установка
comfy install --fast-deps

# uv-compile для управления пользовательскими узлами (требуется ComfyUI-Manager v4.1+)
comfy node install comfyui-impact-pack --uv-compile

# Запуск отдельно (разрешить все зависимости существующих пользовательских узлов)
comfy node uv-sync

# Сделать --uv-compile режимом по умолчанию
comfy manager uv-compile-default true

Управление снимками узлов

comfy node save-snapshot                           # Сохранить текущий снимок
comfy node restore-snapshot <snapshot_name>        # Восстановить сохраненный снимок

Управление зависимостями

comfy node install-deps --workflow=workflow.json   # Из JSON-файла рабочего процесса
comfy node install-deps --workflow=workflow.png    # Из PNG-изображения рабочего процесса
comfy node install-deps --deps=dependencies.json   # Из JSON-файла зависимостей
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json

Поиск неисправностей узлов (Бисекция)

Определить, какой пользовательский узел вызывает ошибку:

comfy node bisect start                            # Начать сессию бисекции
comfy node bisect good                             # Отметить текущее состояние как хорошее
comfy node bisect bad                              # Отметить текущее состояние как плохое
comfy node bisect reset                            # Сбросить сессию

## Генерация изображений без JSON-схемы рабочего процесса

Comfy CLI может напрямую вызывать партнёрские модели изображений и видео: для этого не требуется граф рабочего процесса.

```bash
comfy generate --prompt "a cat on a beach" --model flux/schnell
comfy generate --prompt "anime girl" --model stability/stable-diffusion-3.5
comfy generate --prompt "city street" --model ideogram/ideogram-v2

Поддерживаемые провайдеры включают: Flux, Ideogram, DALL·E, Recraft, Stability, Gemini, Kling, Luma, Runway, Pika, Vidu, Hailuo, Seedance и другие.

Запуск в облаке

Запускайте любой рабочий процесс на Comfy Cloud (локальный GPU не требуется):

comfy launch -- --where cloud
# или
comfy generate --model recraft/recraft-v3 --where cloud

Структурированный вывод для агентов

Каждая команда поддерживает --json для машинно-читаемого вывода: это идеально подходит для CI/CD и интеграции с AI-агентами.

comfy generate --prompt "a cat" --model flux/schnell --json

## Управление моделями

### Загрузка моделей

```bash
# From Hugging Face
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

# From CivitAI
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints

# With API token
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token YOUR_TOKEN

API-токены также можно задавать через переменные окружения (CIVITAI_API_TOKEN, HF_API_TOKEN) — это безопаснее для CI/CD-сред.

Команды управления моделями

comfy model list                                  # Список моделей в пути по умолчанию
comfy model list --relative-path models/loras     # Список в подпапке
comfy model remove --model-names "model.safetensors"  # Удаление модели

## Управление ComfyUI-Manager

```bash
comfy manager disable-gui                         # Отключить GUI менеджера
comfy manager enable-gui                          # Включить GUI менеджера
comfy manager clear                               # Очистить зарезервированные действия при запуске

## Информация об окружении

```bash
comfy env                                         # Показать подробную информацию об окружении
comfy tracking status                             # Проверить настройки отслеживания
comfy tracking disable                            # Отключить отслеживание использования
comfy tracking enable                             # Включить отслеживание использования

## Расширенные функции

### comfy-lock.yaml (Бета)

Используйте файл `comfy-lock.yaml` для управления зависимостями проекта:

```yaml
basic:

models:
  - model: SD1.5 Base
    url: https://huggingface.co/...
    paths:
      - path: models/checkpoints
    hashes:
      - hash: abc123...
        type: SHA256
    type: checkpoint

custom_nodes:
  git_custom_nodes:
    https://github.com/user/ComfyUI-Node:
      disabled: false
      hash: a1b2c3d...

## Обычные сценарии использования

### Управление средой разработки

```bash
# Создание рабочей области для стабильной разработки
comfy --workspace=~/dev/comfyui-stable install

# Создание рабочей области для экспериментальных возможностей
comfy --workspace=~/dev/comfyui-experimental install

# Установка экспериментальных узлов
comfy --workspace=~/dev/comfyui-experimental node install ComfyUI-AnimateDiff-Evolved

Управление зависимостями проекта

# Создание снимка для проекта
comfy node save-snapshot my-project-v1

# Восстановление зависимостей проекта
comfy node restore-snapshot my-project-v1

# Установка зависимостей рабочего процесса
comfy node install-deps --workflow=project.json

## Устранение неполадок

### Типичные проблемы

1. **Проблемы с путём рабочей области**
   ```bash
   comfy which              # Проверить текущую рабочую область
   comfy set-default /path  # Сбросить на правильный путь

Конфликты узлов

comfy node bisect start  # Используйте bisect для поиска проблемного узла

Проблемы с разрешениями

ls -la ~/comfy           # Проверить права доступа к каталогу