Comfy-Org/comfy-cli

comfy‑cli의 역할

comfy‑cli는 AI 모델(예: Stable Diffusion, Flux, DALL·E 등)을 사용하여 이미지, 비디오 및 기타 미디어를 생성하는 오픈 소스 엔진인 ComfyUI를 설치, 실행 및 확장하는 데 도움을 주는 Python 기반 명령줄 인터페이스입니다. ComfyUI 저장소를 수동으로 클론하고, Python 종속성을 설치하며, JSON 워크플로우 파일을 만지는 대신, comfy install, comfy run, 또는 comfy generate와 같은 간단한 명령어를 입력하면 됩니다.

핵심 기능

기능	사용자에게 주는 의미
한 번의 명령어로 설치 및 실행	`comfy setup` (또는 `comfy install` + `comfy launch`)을 통해 최신 ComfyUI 코드, 매니저, 그리고 모든 필요한 Python 패키지를 한 번에 다운로드합니다.
직접적인 모델 호출	`comfy generate`를 사용하면 UI 워크플로우 JSON을 직접 만들 필요 없이 파트너 이미지/비디오 노드(Flux, DALL·E, Stability AI 등)와 통신할 수 있습니다.
커스텀 노드 관리	`comfy node install <id>` 및 `comfy node update all`과 같은 명령어를 통해 Comfy Registry 또는 GitHub에서 커스텀 노드 팩을 설치, 업데이트, 스냅샷 생성 또는 이진 탐색(bisect)할 수 있습니다.
빠른 종속성 해결	`--fast-deps` 또는 `--uv-compile` 플래그를 사용하면 `uv` 리졸버를 사용하여 모든 노드에 대한 단일 락파일(lockfile)을 컴파일하므로 설치 속도가 눈에 띄게 빨라집니다.
모델 다운로드	단 한 번의 명령어로 CivitAI, Hugging Face 또는 모든 URL에서 모델을 가져옵니다.
로컬 또는 클라우드 워크플로우 실행	`comfy run --workflow file.json --where cloud`를 입력하면 워크플로우를 Comfy Cloud로 전송합니다(GPU가 필요하지 않음). 동일한 명령어가 로컬에서 실행 중인 ComfyUI 서버에서도 작동합니다.
에이전트 친화적인 JSON 출력	`--json`을 추가하면 모든 명령어가 구조화된 엔벨로프(envelope)를 출력하며, 이는 LLM 기반 에이전트(Claude, Cursor 등)가 파싱하고 실행할 수 있습니다.
크로스 플랫폼	Windows, macOS, Linux에서 작동하며, virtualenv, conda env 또는 `pipx`를 통해 설치할 수 있습니다.
셸 자동 완성	`comfy --install-completion`을 통해 모든 하위 명령어 및 옵션에 대한 탭 자동 완성을 제공합니다.

일반적인 워크플로우

CLI 설치 – pip install comfy-cli (Python 3.10+).
ComfyUI 설정 – comfy setup (대화형 위저드) 또는 comfy install.
노드 또는 모델 추가 – comfy node install comfyui‑impact‑pack 또는 comfy model download <url>.
생성 실행 – comfy generate --prompt "a cyberpunk city at night" (로컬) 또는 호스팅된 서비스를 사용하려면 --where cloud를 추가합니다.
결과물 회수 – comfy download <prompt_id> -o ./outputs.

왜 중요한가

ComfyUI는 AI 기반 미디어 생성에 강력하지만 수동 작업이 많은 플랫폼입니다. comfy‑cli는 설정, 종속성 지옥, 그리고 JSON 전용 워크플로우 실행의 번거로움을 제거하여, 개발자, CI 파이프라인, 및 프로그래밍 방식으로 이미지 생성을 호출해야 하는 AI 에이전트가 이 엔진을 쉽게 사용할 수 있도록 만듭니다.

빠른 참조 (선택된 명령어)

comfy install – ComfyUI + 매니저 다운로드.
comfy launch – UI 서버 시작 (데몬화하려면 --background 추가).
comfy generate – 터미널에서 파트너 모델을 직접 호출.
comfy run --workflow FILE.json [--where cloud] – 저장된 워크플로우 실행.
comfy node install <registry‑id> – 커스텀 노드 팩 추가.
comfy update all – ComfyUI 및 설치된 모든 노드 업데이트.
comfy cloud login / comfy cloud status – 호스팅된 Comfy Cloud 계정 관리.
comfy --json <subcommand> – LLM 에이전트를 위한 기계 판독 가능 출력.

누가 사용해야 하는가?

개발자 – 설치, CI 테스트 또는 자동화된 생성을 스크립트화하고 싶은 경우.
연구원 – 생성형 미디어 실험을 위해 재현 가능한 환경이 필요한 경우.
LLM 기반 에이전트 (Claude, Cursor 등) – 이미지 생성을 구동하기 위한 안정적인 JSON 인터페이스가 필요한 경우.
아티스트 – 터미널 사용이 익숙하며 ComfyUI를 빠르게 실행하고 다양한 모델 제공업체를 이용하고 싶은 경우.

더 자세히 배우기

GitHub 저장소 – https://github.com/Comfy-Org/comfy-cli (README, 이슈 트래커, CI 상태 배지). -ComfyUI 프로젝트 – https://github.com/comfyanonymous/ComfyUI (이 CLI가 래핑하는 엔진). -Comfy Cloud – https://www.comfy.org/ ( --where cloud를 통해 사용하는 호스팅 GPU 서비스).

위의 모든 상세 내용은 프로젝트의 README에서 직접 가져온 것이며, 추가적인 기능은 추론되지 않았습니다.