comfy-cli는 Comfy를 더 쉽게 설치하고 관리할 수 있게 해주는 명령줄 도구입니다.
이 도구는 두 가지 기능을 수행합니다:
- 로컬 ComfyUI 설치 관리 — ComfyUI와 맞춤형 노드를 설치, 실행, 업데이트, 스냅샷 및 분석합니다.
- 호스팅된 파트너 노드 직접 호출 — Seedance, Nano Banana (Gemini), Grok, Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, Moonvalley 등에서 이미지와 비디오를 단일 명령어로 생성합니다. 로컬 ComfyUI나 워크플로우 JSON이 필요하지 않습니다.
CLI 설치
To get shell completion hints:
comfy --install-completion
ComfyUI 설치
Create a virtual environment with any Python version greater than 3.9.
conda create -n comfy-env python=3.11
conda activate comfy-env
You still need to install CUDA, or ROCm depending on your GPU.
ComfyUI 실행
comfy generate를 사용해 파트너 노드 직접 호출하기 (베타)
comfy generate는 베타 버전입니다. 플래그 이름, 모델 별칭, 출력 형식은 피드백을 바탕으로 최적화 과정에서 변경될 수 있습니다. 기본 제공되는 파트너 엔드포인트는 안정적이며, 이 위에 구축된 CLI의 편의성만 아직 발전 중입니다. comfy-cli GitHub 리포지토리에 피드백이나 이슈를 제출해 주세요.comfy generate는 터미널이나 스크립트에서 Comfy의 파트너 노드를 호출하는 가장 빠른 방법입니다. 이는 기존에 ComfyUI 워크플로우에 연결하던 동일한 호스팅 엔드포인트를 사용하지만, 일회성 CLI 호출 방식으로 처리됩니다. 전체 ComfyUI 그래프를 구성하는 것이 불필요한 배치 작업, 빠른 실험, 자동화 파이프라인에 적합합니다.사전 요구사항
키를 한 번 설정한 후 다음을 실행하세요:
export COMFY_API_KEY=comfyui-... # 또는 각 호출 시 --api-key 옵션 전달
첫 번째 생성
comfy generate flux-pro \
--prompt "달 위의 고양이, 영화 같은 조명" \
--width 1024 --height 1024 \
--download cat.png
cat.png에 저장합니다.
인기 있는 모델들
몇 가지 가장 많이 사용되는 파트너 모델들은 한 줄로 호출 가능합니다:
# Nano Banana (Google Gemini Flash Image) — 텍스트-to-이미지 및 프롬프트 기반 편집
comfy generate nano-banana \
--prompt "수채화로 그린 잠든 여우" \
--download fox.png
# 같은 별칭, 이번에는 이미지 편집 — --image 옵션으로 참조 이미지를 전달하세요(반복 가능):
comfy generate nano-banana \
--prompt "모자를 추가하세요" \
--image ./cat.png \
--download edited.png
# Gemini 변형 선택:
comfy generate nano-banana \
--prompt "네온 도시의 스카이라인" \
--model gemini-3-pro-image-preview \
--download city.png
# Seedance (ByteDance) — 텍스트-to-비디오, 최대 1080p / 12초 클립
comfy generate seedance \
--prompt "꽃 위에 매달린 벌새" \
--resolution 1080p --duration 5 \
--download hummingbird.mp4
# Seedance 이미지-to-비디오 — lite/i2v 변형을 선택하고 첫 프레임을 전달하세요
comfy generate seedance \
--model seedance-1-0-lite-i2v-250428 \
--prompt "파도가 치고 부서지는 모습" \
--image ./still.jpg \
--download wave.mp4
# Grok (xAI) — 이미지 생성 및 편집
comfy generate grok --prompt "야간 사이버펑크 거리 시장" --download street.png
comfy generate grok-edit --prompt "우산을 양산으로 교체하세요" --image ./photo.jpg --download out.png
# Grok 비디오
comfy generate grok-video --prompt "대성당을 통과하는 종이 비행기" --download flight.mp4
모델 탐색하기
comfy generate list # 사용 가능한 모든 모델
comfy generate list --category text-to-video # 카테고리별 필터링
comfy generate list --partner kling # 파트너별 필터링
comfy generate schema flux-kontext # 특정 모델의 파라미터 보기
참조 이미지와 함께 이미지 편집하기
로컬 파일 경로를 직접 전달하세요—CLI는 Comfy의 스토리지 엔드포인트를 통해 업로드하거나(각 파트너가 요구하는 대로 base64로 인코딩됨):
comfy generate flux-kontext \
--prompt "모자를 추가하고 돋보기를 써보세요" \
--input_image ./photo.jpg \
--download out.png
comfy generate ideogram-edit \
--image cat.png --mask mask.png \
--prompt "선글라스를 추가하세요" \
--rendering_speed TURBO \
--download edited.png
comfy generate upload ./photo.jpg
# → 서명된 URL이 출력되며, 이를 --input_image 옵션으로 전달할 수 있습니다
업로드된 참조 자산은 24시간 후에 자동 삭제됩니다. 이들은 Comfy가 관리하는 GCS 버킷에 저장되고 서명된 URL을 통해 제공됩니다. 대부분의 워크플로우(업로드 → 사용 → 완료)에서는 이 과정이 투명하게 작동하지만, 장기간 실행되는 파이프라인에서는 각 작업 전에 다시 업로드하도록 계획하세요. 자세한 내용은 참조를 참고하세요. 비디오 생성 (비동기 작업)
비디오 작업은 비동기 방식이며, 기본적으로 CLI는 차단하고 준비될 때까지 폴링합니다:
comfy generate kling \
--prompt "황혼녘 강물 위에 떠 있는 종이배" \
--duration 5 \
--download boat.mp4
--async 옵션을 전달하면 즉시 작업 ID를 반환한 후 나중에 다시 진행할 수 있습니다:
comfy generate luma --prompt "네온 잉어가 구름 속을 헤엄치다" --aspect_ratio 16:9 --async
# → 작업 ID가 출력됩니다; 이후 다음 명령어로 다시 진행하세요:
comfy generate resume luma <job_id> --download out.mp4
JSON 출력을 이용한 스크립팅
파이프라인을 위해 --json 옵션은 원시 API 응답을 출력합니다:
comfy generate dalle --prompt "수채화 고래" --json | jq '.data[0].url'
맞춤형 노드 관리하기
comfy node install <NODE_NAME>
cm-cli를 사용합니다. 자세한 내용은 문서를 참고하세요.
모델 관리하기
comfy-cli를 이용한 모델 다운로드는 간편합니다. 다음 명령어를 실행하세요:
comfy model download --url <url> --relative-path models/checkpoints
기여하기
comfy-cli에 대한 기여를 환영합니다! 제안, 아이디어, 버그 보고가 있다면 GitHub 리포지토리에 이슈를 열어주세요. 코드 기여를 원한다면 리포지토리를 포크하고 풀 리퀘스트를 제출해 주세요.
자세한 내용은 개발 가이드를 참고하세요.
CLI 사용량을 추적하여 사용자 경험을 개선합니다. 다음 명령어를 실행해 이 기능을 비활성화할 수 있습니다:
추적을 다시 활성화하려면 다음 명령어를 실행하세요:
