Black Forest Labs выпускает открытую версию FLUX.1 Krea [dev] с нативной поддержкой ComfyUI
31.07.2025
Полное руководство пользователя 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 автоматически выберет на основе следующего приоритета:
- Путь ComfyUI по умолчанию, указанный через
comfy set-default <path>
- Наиболее недавно выполненный или установленный ComfyUI
- 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"
Устранение неполадок
Общие проблемы
-
Проблемы с путем рабочего пространства
# Проверить текущее рабочее пространство comfy which # Если путь неверен, сбросьте его comfy set-default /correct/path
-
Проблемы с конфликтами узлов
# Используйте функцию бисекции для определения проблем comfy node bisect start # Отметьте нормальное/проблемное состояние по запросу
-
Проблемы с разрешениями
# Убедитесь в наличии достаточных разрешений ls -la ~/comfy
Связанные ссылки
- Репозиторий Comfy CLI GitHub
- Официальная документация Comfy CLI
- Руководство по установке ComfyUI на Linux
- Основной репозиторий ComfyUI