개요
comfy-cli는 Comfy의 설치 및 관리를 간소화하고 로컬 또는 클라우드에서 전체 ComfyUI 생태계에 대해 스크립트 가능한 단일 명령 액세스를 제공하는 명령줄 도구입니다.
세 가지 주요 기능을 제공합니다:
- 로컬 ComfyUI 설치 관리: ComfyUI 및 커스텀 노드 설치, 실행, 업데이트, 스냅샷, bisect.
- 호스팅된 파트너 노드 접근: 단일 명령으로 Seedance, Nano Banana (Gemini), Grok, Flux, Ideogram, DALL·E, Recraft, Stability, Kling, Luma, Runway, Pika, Vidu, Hailuo, Moonvalley 등 제공업체의 이미지, 비디오, 오디오, 3D 생성.
- Comfy Cloud에서 전체 워크플로 실행: 워크플로 그래프 제출, 큐레이션된 템플릿 갤러리 찾아보기, 워크플로 슬롯 편집, 로컬 GPU 없이 작업 완료까지 모니터링.
두 가지 표면, 하나의 CLI. 모든 명령이 자동으로 실행 위치를 감지합니다. Comfy Cloud에 로그인한 경우 명령은 클라우드로 라우팅되고, 그렇지 않으면 로컬 서버에서 실행됩니다. 각 호출 시
--where local|cloud로 재정의하거나, COMFY_WHERE 환경 변수를 사용하거나, comfy set-default --where cloud로 영구 설정할 수 있습니다.CLI 설치
빠른 설정 (권장)
최근 버전의 새로운 기능: 한 번에 라우팅, 인증 및 에이전트 기술을 처리하는 단일 대화형 마법사입니다.비대화형(CI 전용). 브라우저 OAuth는 대화형 세션이 필요합니다. CI, devcontainer 및 브라우저를 사용할 수 없는 스크립트 설치의 경우 API 키를 대신 전달하세요:
| 플래그 | 목적 |
|---|---|
--where local|cloud | 라우팅 대상; 프롬프트 생략 |
--project-dir | 워크플로, 입력 및 출력 디렉터리 |
--api-key | (선택 사항) 헤드리스/CI용 Comfy Cloud API 키이며, --where cloud를 암시합니다. |
-y, --non-interactive | 프롬프트 없음. 모든 것을 플래그로 처리합니다. |
--skip-skills | 에이전트 기술을 설치하지 않음 |
--skip-verify | 연결 확인 건너뛰기 |
ComfyUI 설치 (로컬)
Python 버전 3.9보다 높은 버전을 사용하여 가상 환경을 생성하세요.ComfyUI 실행 (로컬)
Comfy Cloud
Comfy의 호스팅 GPU에서 워크플로와 파트너 노드를 실행하세요. 로컬 설치가 필요 없습니다.API 키는 선택 사항입니다. 브라우저 로그인이 불가능한 헤드리스 또는 CI 사용에서만 API 키가 필요합니다. 이는 기본값이 아닌 대체 수단입니다:
세션 수명. 클라우드 세션 토큰은 수명이 짧습니다(~1시간). CLI는 필요에 따라 자동으로 새로 고칩니다. 명령에서
cloud_unauthorized를 보고하면 comfy cloud login을 다시 실행하세요.파트너 노드로 생성하기
comfy generate는 베타 버전입니다. 플래그명, 모델 별칭 및 출력 형식은 변경될 수 있습니다. 기본 파트너 엔드포인트는 안정적입니다. 피드백은 comfy-cli GitHub 저장소에 제출해 주세요.사전 준비 사항
- 활성 Comfy Cloud 세션.
comfy cloud login실행 (브라우저 OAuth) - 계정에 크레딧 보유
- 선택 사항: 세션 대신 Comfy API 키 (
--api-key/COMFY_API_KEY). 헤드리스 또는 CI 환경용 - 선택 사항: 파트너 노드 및 호출당 가격 찾아보기
첫 번째 생성
일반적인 모델
Nano Banana (Google Gemini): 텍스트 기반 이미지 생성 및 편집:모델 검색
참조 이미지를 사용한 이미지 편집
로컬 파일 경로를 전달합니다. CLI는 Comfy의 스토리지 엔드포인트를 통해 업로드하거나 필요에 따라 base64로 인코딩합니다:업로드된 참조 에셋은 24시간 이후 자동으로 삭제됩니다. Comfy 관리 GCS에 서명된 URL로 저장됩니다. 오래 실행되는 파이프라인의 경우 각 작업 이전에 다시 업로드하세요. 자세한 내용은 참조를 확인하세요.
비디오 생성 (비동기 작업)
비디오 작업은 비동기입니다. CLI는 기본적으로 차단 및 폴링합니다:--async를 사용하면 즉시 반환하고 나중에 다시 시작합니다:
스크립트용 JSON 출력
파이프라인 통합을 위해 원시 API 응답을 내보냅니다:워크플로 실행 (comfy run)
단일 파트너 호출을 넘어, comfy run은 완전한 ComfyUI 워크플로 그래프를 제출합니다. API 형식과 내보낸 UI 형식 JSON을 모두 허용하며 (UI 워크플로는 클라이언트 측에서 API 형식으로 변환됨), 다른 모든 명령과 마찬가지로 로컬 또는 클라우드로 라우팅합니다. 기본적으로 비동기입니다. 백그라운드 감시자가 진행 상황을 추적하는 동안 밀리초 단위로 prompt_id를 반환합니다. 대신 --wait를 전달하여 차단합니다.
--wait를 사용하세요:
템플릿으로 시작하기
엄선된Comfy-Org/workflow_templates 갤러리는 주어진 작업에 대한 검증된 워크플로를 얻는 가장 빠른 방법입니다. 처음부터 만들 필요가 없습니다.
comfy run --where cloud가 제출 시 자동으로 API 형식으로 변환합니다.
워크플로 직접 편집
comfy workflow 명령어는 프론트엔드 형식의 모든 워크플로에서 에이전트가 조정 가능한 슬롯을 노출하고 덮어쓸 수 있게 해줍니다. 수동으로 JSON을 수정할 필요가 없습니다.
노드 및 모델 발견
해결된 백엔드에서 사용할 수 있는 모든 것을 검사하세요. 노드:파일 업로드 및 다운로드
커스텀 노드 관리
cm-cli를 사용합니다. 자세한 내용은 ComfyUI Manager cm-cli 문서를 참조하세요.
모델 관리 (로컬)
모델을 쉽게 다운로드합니다:스크립트 및 에이전트를 위한 JSON 출력
모든 명령은--json을 허용하며 동일한 봉투 형태를 출력하므로 CLI를 완전히 스크립트 가능하고 에이전트 친화적으로 만듭니다:
error가 있을 때는 hint를 읽고 그에 따라 조치하십시오:
에이전트 스킬
번들된 Comfy 에이전트 스킬을 Claude Code, Cursor 및 AGENTS.md를 인식하는 모든 도구에 설치하여 코딩 에이전트가 CLI를 직접 사용할 수 있도록 합니다:이는
comfy skills install로 설치되는 번들된 CLI 스킬입니다. Comfy Cloud MCP용 comfy-cloud Claude Code 플러그인을 호스팅하는 Comfy Skills 저장소와는 별개입니다.기여하기
기여를 환영합니다. comfy-cli GitHub 저장소에서 이슈를 열거나 풀 리퀘스트를 제출해 주세요. 자세한 세부 정보는 개발 전용 가이드를 참조하세요.분석
사용 추적은 CLI 개선에 도움이 됩니다. 다음 명령으로 비활성화할 수 있습니다:DO_NOT_TRACK 또는 COMFY_NO_TELEMETRY 환경 변수를 통해 완전히 비활성화할 수도 있습니다.