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

Комплексное руководство по всем функциям Comfy CLI, включая управление рабочими пространствами, управление узлами, управление моделями и другие продвинутые функции.

Comfy CLI - это официальный инструмент командной строки, предоставляемый ComfyUI. Он не только упрощает процесс установки ComfyUI, но и предлагает мощные возможности управления. Это руководство комплексно охватит все функции Comfy CLI.

Базовые команды

Установка и настройка

# Установить comfy-cli
pip install comfy-cli

# Включить автодополнение командной строки
comfy --install-completion

# Установить ComfyUI
comfy install

# Запустить ComfyUI
comfy launch

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

comfy-cli поддерживает управление множественными рабочими пространствами ComfyUI, позволяя вам поддерживать различные среды ComfyUI одновременно:

Базовые операции с рабочими пространствами

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

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

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

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

1. Указать рабочее пространство:

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

# Установить узлы в указанном рабочем пространстве
comfy --workspace=/path/to/workspace node install ComfyUI-Impact-Pack

2. Использовать недавнее рабочее пространство:

# Запустить наиболее недавно использованный ComfyUI
comfy --recent launch

# Обновить узлы в недавнем рабочем пространстве
comfy --recent node update all

3. Операции в текущей директории:

# Установить узлы в ComfyUI текущей директории
comfy --here node install ComfyUI-Impact-Pack

# Запустить ComfyUI в текущей директории
comfy --here launch

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

Ограничения опций рабочего пространства

Важное примечание: Опции --workspace, --recent и --here не могут использоваться одновременно.

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

Когда вы не указываете явно рабочее пространство, comfy-cli автоматически выберет на основе следующего приоритета:

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

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

Сценарий 1: Создание независимых сред для различных проектов

# Создать рабочее пространство для Проекта A
comfy --workspace=~/projects/projectA install

# Создать рабочее пространство для Проекта B
comfy --workspace=~/projects/projectB install

# Установить конкретные узлы в Проекте A
comfy --workspace=~/projects/projectA node install ComfyUI-AnimateDiff-Evolved

# Установить различные узлы в Проекте B
comfy --workspace=~/projects/projectB node install ComfyUI-Impact-Pack

Сценарий 2: Быстрое переключение сред

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

# Временно работать в другом рабочем пространстве
comfy --workspace=~/projects/test-workspace launch

# Вернуться к рабочему пространству по умолчанию
comfy launch

Опции запуска

ComfyUI предоставляет богатые опции запуска для удовлетворения различных требований:

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

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

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

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

Сетевая конфигурация

# Указать адрес прослушивания и порт
comfy launch -- --listen 0.0.0.0 --port 8080

# Разрешить внешний доступ
comfy launch -- --listen 0.0.0.0

Оптимизация производительности

# Использовать режим CPU
comfy launch -- --cpu

# Режим низкого VRAM
comfy launch -- --lowvram

# Режим ультра-низкого VRAM
comfy launch -- --novram

# Включить выгрузку моделей на CPU
comfy launch -- --cpu-vae

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

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

# Показать всю доступную информацию об узлах
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 install ComfyUI-Impact-Pack

# Обновить все узлы
comfy node update all

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

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

Функция снимка помогает вам сохранять и восстанавливать состояния конфигурации узлов:

# Сохранить снимок узла
comfy node save-snapshot

# Просмотреть список снимков
comfy node show snapshot-list

# Восстановить снимок узла
comfy node restore-snapshot <snapshot_name>

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

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

# Установить зависимости из файла рабочего процесса PNG
comfy node install-deps --workflow=workflow.png

# Установить из файла JSON зависимостей
comfy node install-deps --deps=dependencies.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

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

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

# Загрузить модели из URL (поддерживают CivitAI, Hugging Face и т.д.)
comfy model download --url https://huggingface.co/model/url

# Загрузить в указанный относительный путь
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints

# Установить токен API CivitAI (для загрузки моделей с требованием входа)
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token YOUR_TOKEN

# Комбинировать несколько опций
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints

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

# Список всех моделей по умолчанию
comfy model list

# Список моделей в указанном пути
comfy model list --relative-path models/loras

# Удалить указанные модели
comfy model remove --model-names "model1.safetensors,model2.ckpt"

# Удалить модели из указанного пути
comfy model remove --relative-path models/checkpoints --model-names "old_model.ckpt"

Поддерживаемые источники моделей

  • Hugging Face: Используйте прямые URL-адреса файлов
  • CivitAI: Используйте URL-адреса API для загрузки моделей
  • Другие прямые ссылки: Любые прямо скачиваемые URL-адреса файлов моделей

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

comfy-cli также может управлять настройками ComfyUI-Manager:

# Отключить GUI ComfyUI-Manager (меню и сервер)
comfy manager disable-gui

# Включить GUI ComfyUI-Manager
comfy manager enable-gui

# Очистить зарезервированные действия запуска при запуске
comfy manager clear

Информация о среде

Просмотрите подробную информацию о текущей среде ComfyUI:

# Показать информацию о среде, включая статус запуска, рабочее пространство и т.д.
comfy env

# Проверить статус настроек отслеживания
comfy tracking status

# Отключить отслеживание использования
comfy tracking disable

# Включить отслеживание использования
comfy tracking enable

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

Бета-функция: comfy-lock.yaml

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

basic:

models:
  - model: [Название модели]
    url: [URL-адрес источника модели, например, https://huggingface.co/...]
    paths: [Список путей к моделям]
      - path: [Путь к модели]
      - path: [Путь к модели]
    hashes: [Хэши моделей]
      - hash: [Значение хэша]
        type: [AutoV1, AutoV2, SHA256, CRC32, Blake3]
    type: [Тип модели, например, diffuser, lora и т.д.]

# Совместим с моментами снимков .yaml ComfyUI-Manager
custom_nodes:
  comfyui: [commit hash]
  file_custom_nodes:
  - disabled: [bool]
    filename: [.py имя файла]
    ...
  git_custom_nodes:
    [git-url]:
      disabled: [bool]
      hash: [commit hash]
    ...

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

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

# Создать среду разработки
comfy --workspace=~/dev/comfyui-dev install

# Создать среду тестирования
comfy --workspace=~/test/comfyui-test install

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

# Быстро переключиться на среду тестирования для тестирования
comfy --workspace=~/test/comfyui-test launch

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

# Создать снимок зависимостей проекта
comfy node save-snapshot project-v1.0

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

# Восстановить зависимости до конкретной версии
comfy node restore-snapshot project-v1.0

Автоматическое управление моделями

# Пакетная загрузка необходимых моделей для проекта
comfy model download --url https://huggingface.co/model1 --relative-path models/checkpoints
comfy model download --url https://huggingface.co/model2 --relative-path models/loras

# Очистка старых моделей
comfy model remove --model-names "old_model1.ckpt,old_model2.safetensors"

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

Общие проблемы

  1. Проблемы с путем рабочего пространства

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

# Если путь неверен, сбросьте его
comfy set-default /correct/path

  2. Проблемы с конфликтами узлов

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

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

    # Убедитесь в наличии достаточных разрешений
ls -la ~/comfy

Связанные ссылки