Comfy-Org/comfy-cli

comfy‑cli – ComfyUI의 명령줄 관리자

무엇인가요

• 오픈소스 생성 미디어 엔진인 ComfyUI의 전체 라이프사이클을 자동화하는 Python 기반 CLI입니다. ComfyUI 설치, 커스텀 노드 가져오기, 모델 다운로드, 서버 실행, 워크플로우 실행, 심지어 호스팅된 Comfy Cloud 서비스에 작업 제출까지 가능합니다.

주요 기능

기능	기능 설명
단일 명령어 설치 및 실행	comfy install (또는 comfy setup)은 ComfyUI와 공식 매니저를 다운로드하고 단일 명령어로 실행할 수 있게 합니다.
클라우드 실행	comfy run … --where cloud는 API 형식 워크플로우를 Comfy Cloud로 전송하고 prompt_id를 반환하며, 나중에 결과를 풀링하거나 다운로드할 수 있습니다.
직접 생성	comfy generate는 JSON 워크플로우를 작성하지 않고도 파트너 이미지/비디오 모델(Flux, DALL·E, Stability 등)을 호출할 수 있습니다.
커스텀 노드 관리	comfy node …를 통해 노드 설치, 업데이트, 스냅샷, 바이섹션, 일괄 업데이트가 가능합니다. 표준 ComfyUI‑Manager 흐름과 레지스트리 직접 흐름 모두 지원합니다.
빠른 종속성 해결	--fast-deps 또는 --uv-compile는 uv 리졸버를 사용해 모든 노드용 단일 락파일을 컴파일하여 설치 속도를 크게 향상시킵니다.
모델 가져오기	단일 명령어로 CivitAI, Hugging Face, 또는 임의의 URL에서 모델을 다운로드할 수 있습니다.
크로스플랫폼	Windows, macOS, Linux에서 작동 가능하며, Docker 또는 virtualenv 내에서도 실행 가능합니다.
에이전트 친화적 출력	--json 플래그는 모든 응답을 구조화된 래퍼로 감싸, LLM 에이전트(Claude, Cursor 등)가 도구를 쉽게 제어할 수 있도록 합니다.
쉘 완성	comfy --install-completion은 Bash/Zsh/Fish의 탭 완성 기능을 추가합니다.
백그라운드 서버 관리	comfy launch --background는 분리된 ComfyUI 인스턴스를 시작하며, comfy env 또는 comfy stop으로 목록 확인 및 중지가 가능합니다.
PR 테스트 및 캐시	comfy launch --frontend-pr … 또는 comfy install --pr …를 통해 GitHub 풀리퀘스트에서 UI 또는 백엔드를 실행할 수 있으며, 자동 캐시 정리도 가능합니다.

일반적인 워크플로우

1. 설치 – pip install comfy-cli && comfy setup (인터랙티브 워즈드) 또는 CI용 comfy install -y.
2. 노드/모델 추가 – comfy node install comfyui-impact-pack 또는 comfy node registry-install …; comfy model download <url>.
3. 로컬 실행 – comfy launch (옵션으로 --background).
4. 워크플로우 실행 – comfy run --workflow my.json (로컬) 또는 --where cloud를 추가해 호스팅 서비스로 오프로드.
5. 모니터링/다운로드 – comfy jobs wait <id>, comfy download <id> -o ./out.
6. 업데이트 – comfy update all (코어 + 노드) 또는 comfy update comfy --version latest.

왜 중요한가요

• 장벽 감소: ComfyUI를 수동으로 설정하려면 리포지토리 복제, Python 환경 설치, GPU 전용 PyTorch 웨어러블 처리, 수동 커스텀 노드 가져오기 등이 필요합니다. comfy‑cli는 이러한 모든 단계를 통합합니다.
• 클라우드 우선 파이프라인을 쉽게 만듭니다: GPU가 없는 사용자도 단일 플래그로 Comfy Cloud로 라우팅하여 무거운 확산 모델을 실행할 수 있습니다.
• 자동화를 촉진합니다: JSON 래퍼와 결정론적 종료 코드 덕분에 CI 파이프라인이나 LLM 기반 에이전트가 설치, 업데이트, 작업 제출을 신뢰성 있게 스크립트화할 수 있습니다.
• 통합된 종속성 처리: uv와 매니저의 통합 리졸버를 활용해 여러 커스텀 노드 간의 버전 충돌을 조기에 탐지하여 시간을 절약합니다.

설치

# 권장: virtualenv 또는 conda 환경 내에서
pip install comfy-cli   # Python ≥3.10
# 옵션: 탭 완성 활성화
comfy --install-completion

도움 받기

• comfy --help – 최상위 명령어 목록.
• comfy <하위명령어> --help – 각 작업에 대한 상세 옵션.
• comfy which – CLI가 작동할 워크스페이스를 표시.
• comfy env – 현재 환경, 백그라운드 서버, 클라우드 상태를 표시.

라이선스 및 커뮤니티

• MIT 라이선스 하에 배포.
• Comfy‑Org 팀에서 적극적으로 유지보수 중이며, CI 배지로 테스트 커버리지와 PyPI 릴리스를 확인할 수 있습니다.

---

위 정보는 프로젝트의 README에서 직접 가져왔으며, 외부 가정은 추가되지 않았습니다.