Skip to content
ComfyUI Wiki
Помогите создать лучшую базу знаний ComfyUI Стать спонсором

Полное руководство пользователя 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

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