RunComfy CLI

Один бинарник, одна авторизация, все модели RunComfy. Установите один раз, войдите один раз — и вызывайте любой эндпоинт text-to-image, video, edit, lip-sync, face-swap или LoRA-обучения командой runcomfy run <model_id> --input '{...}'. Этот скилл — основа, на которой строятся все остальные runcomfy-* скиллы.

npx skills add agentspace-so/runcomfy-agent-skills --skill runcomfy-cli -g

Установка CLI

# Глобальная установка через npm (рекомендуется)
npm i -g @runcomfy/cli

# Без установки — одноразовый запуск
npx -y @runcomfy/cli --version

# Подтверждение
runcomfy --version

Авторизация

# Интерактивно (открывает браузер)
runcomfy login
# Код показывается в терминале — вставьте в браузере и нажмите Authorize
# Токен сохраняется в ~/.config/runcomfy/token.json с правами 0600

# CI / контейнеры (без браузера)
export RUNCOMFY_TOKEN=<токен-с-runcomfy.com/profile>

# Проверка
runcomfy whoami

Запуск модели

runcomfy run <vendor>/<model>/<endpoint> \
  --input '<JSON body>' \
  --output-dir <path>

# Пример — генерация изображения с GPT Image 2
runcomfy run openai/gpt-image-2/text-to-image \
  --input '{"prompt": "a small purple cat at sunset, photorealistic"}'

Обнаружение схемы

Перед вызовом модели всегда смотрите схему входных данных:

runcomfy schema <vendor>/<model>/<endpoint>

# Пример
runcomfy schema openai/gpt-image-2/text-to-image

Схема также доступна на вкладке API каждой страницы модели на runcomfy.com.

Режимы опроса

# Стриминг (по умолчанию) — ждёт завершения и скачивает
runcomfy run <model_id> --input '...' --output-dir ./out

# No-wait — возвращает request_id немедленно
runcomfy run <model_id> --input '...' --no-wait

# Опрос по request_id
runcomfy poll <request_id> --output-dir ./out

JSON-режим для скриптов

runcomfy run <model_id> --input '...' --json
# Возвращает структурированный JSON: request_id, status, output_urls, duration

Команды справочника

runcomfy --help                     # общая справка
runcomfy run --help                  # флаги команды run
runcomfy models                      # список всех эндпоинтов
runcomfy models --filter image       # фильтр по категории
runcomfy schema <model_id>          # схема входных данных модели

Коды завершения

Безопасность

• Токен хранится в ~/.config/runcomfy/token.json с правами 0600. В CI используйте переменную RUNCOMFY_TOKEN. Никогда не выводите токен в лог и не коммитьте его.
• Промпты передаются как JSON через --input. CLI не выполняет shell-expand — нет поверхности для shell-инъекций.
• Исходящие эндпоинты: только model-api.runcomfy.net и *.runcomfy.net / *.runcomfy.com.
• Лимит размера скачиваемого файла: CLI прерывает загрузку при > 2 GiB.

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

• ai-image-generation — умный маршрутизатор по моделям генерации изображений
• ai-video-generation — умный маршрутизатор по видеомоделям
• face-swap — замена лица / персонажа
• ai-avatar-video — talking-head и lip-sync видео
• image-inpainting — редактирование области изображения по маске
• image-outpainting — расширение холста изображения