메인 콘텐츠로 건너뛰기

개요

comfy-cli는 Comfy를 더 쉽게 설치하고 관리할 수 있게 해주는 명령줄 도구입니다. 이 도구는 두 가지 기능을 수행합니다:
  1. 로컬 ComfyUI 설치 관리 — ComfyUI와 커스텀 노드를 설치, 실행, 업데이트, 스냅샷 및 분석합니다.
  2. 호스팅된 파트너 노드 직접 호출 — Seedance, Nano Banana (Gemini), Grok, Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, Moonvalley 등에서 이미지와 비디오를 단일 명령어로 생성합니다. 로컬 ComfyUI나 워크플로우 JSON이 필요하지 않습니다.

CLI 설치

셸 자동완성 힌트를 얻으려면:

ComfyUI 설치

Python 버전 3.9보다 높은 버전을 사용하여 가상 환경을 생성하세요.
ComfyUI 설치하기
GPU에 따라 CUDA 또는 ROCm를 여전히 설치해야 합니다.

ComfyUI 실행

comfy generate를 사용해 파트너 노드 직접 호출하기 (베타)

comfy generate는 베타 버전입니다. 플래그 이름, 모델 별칭, 출력 형식은 피드백을 바탕으로 최적화 과정에서 변경될 수 있습니다. 기본 제공되는 파트너 엔드포인트는 안정적이며, 이 위에 구축된 CLI의 편의성만 아직 발전 중입니다. comfy-cli GitHub 리포지토리에 피드백이나 이슈를 제출해 주세요.
comfy generate는 터미널이나 스크립트에서 Comfy의 파트너 노드를 호출하는 가장 빠른 방법입니다. 이는 기존에 ComfyUI 워크플로우에 연결하던 동일한 호스팅 엔드포인트를 사용하지만, 일회성 CLI 호출 방식으로 처리됩니다. 전체 ComfyUI 그래프를 구성하는 것이 불필요한 배치 작업, 빠른 실험, 자동화 파이프라인에 적합합니다.

사전 요구사항

키를 한 번 설정한 후 다음을 실행하세요:

첫 번째 생성

이것이 전부입니다—CLI는 로컬 파일 입력을 업로드하고, 작업을 제출하며, 준비될 때까지 폴링한 후 결과를 cat.png에 저장합니다.

인기 있는 모델들

몇 가지 가장 많이 사용되는 파트너 모델들은 한 줄로 호출 가능합니다:

모델 탐색하기

참조 이미지와 함께 이미지 편집하기

로컬 파일 경로를 직접 전달하세요—CLI는 Comfy의 스토리지 엔드포인트를 통해 업로드하거나(각 파트너가 요구하는 대로 base64로 인코딩됨):
한 번 업로드하고 여러 호출에서 서명된 URL을 재사용하고 싶다면:
업로드된 참조 자산은 24시간 후에 자동 삭제됩니다. 이들은 Comfy가 관리하는 GCS 버킷에 저장되고 서명된 URL을 통해 제공됩니다. 대부분의 워크플로우(업로드 → 사용 → 완료)에서는 이 과정이 투명하게 작동하지만, 장기간 실행되는 파이프라인에서는 각 작업 전에 다시 업로드하도록 계획하세요. 자세한 내용은 참조를 참고하세요.

비디오 생성 (비동기 작업)

비디오 작업은 비동기 방식이며, 기본적으로 CLI는 차단하고 준비될 때까지 폴링합니다:
--async 옵션을 전달하면 즉시 작업 ID를 반환한 후 나중에 다시 진행할 수 있습니다:

JSON 출력을 이용한 스크립팅

파이프라인을 위해 --json 옵션은 원시 API 응답을 출력합니다:
명령어, 플래그, 모델 별칭의 전체 목록은 참조를 확인하세요.

커스텀 노드 관리하기

커스텀 노드 설치에는 cm-cli를 사용합니다. 자세한 내용은 문서를 참고하세요.

모델 관리하기

comfy-cli를 이용한 모델 다운로드는 간편합니다. 다음 명령어를 실행하세요:

기여하기

comfy-cli에 대한 기여를 환영합니다! 제안, 아이디어, 버그 보고가 있다면 GitHub 리포지토리에 이슈를 열어주세요. 코드 기여를 원한다면 리포지토리를 포크하고 풀 리퀘스트를 제출해 주세요. 자세한 내용은 개발 가이드를 참고하세요.

분석

CLI 사용량을 추적하여 사용자 경험을 개선합니다. 다음 명령어를 실행해 이 기능을 비활성화할 수 있습니다:
추적을 다시 활성화하려면 다음 명령어를 실행하세요: