AMAP, FLUX-Text 장면 텍스트 편집 신기술 발표
2025. 07. 09.
완전한 Comfy CLI 사용자 가이드
Comfy CLI는 ComfyUI에서 제공하는 공식 명령줄 도구입니다. ComfyUI 설치 프로세스를 단순화할 뿐만 아니라 강력한 관리 기능도 제공합니다. 이 가이드는 Comfy CLI의 모든 기능을 포괄적으로 다룹니다.
기본 명령
설치 및 설정
# comfy-cli 설치
pip install comfy-cli
# 명령줄 자동 완성 활성화
comfy --install-completion
# ComfyUI 설치
comfy install
# ComfyUI 실행
comfy launch
작업 공간 관리
comfy-cli는 여러 ComfyUI 작업 공간 관리를 지원하여 동시에 다른 ComfyUI 환경을 유지할 수 있습니다:
기본 작업 공간 작업
# 현재 작업 공간 경로 확인
comfy which
# 기본 작업 공간 설정
comfy set-default /path/to/your/workspace
# 실행 매개변수와 함께 기본 작업 공간 설정
comfy set-default /path/to/your/workspace --launch-extras="--listen 0.0.0.0 --port 8080"
다른 작업 공간에서 명령 실행
1. 작업 공간 지정:
# 지정된 작업 공간에서 ComfyUI 실행
comfy --workspace=/path/to/workspace launch
# 지정된 작업 공간에 노드 설치
comfy --workspace=/path/to/workspace node install ComfyUI-Impact-Pack
2. 최근 작업 공간 사용:
# 가장 최근에 사용된 ComfyUI 실행
comfy --recent launch
# 최근 작업 공간에서 노드 업데이트
comfy --recent node update all
3. 현재 디렉토리에서 작업:
# 현재 디렉토리의 ComfyUI에 노드 설치
comfy --here node install ComfyUI-Impact-Pack
# 현재 디렉토리에서 ComfyUI 실행
comfy --here launch
# 현재 디렉토리에 ComfyUI가 있는지 확인
comfy --here which
작업 공간 옵션 제한
중요 사항:
--workspace
,--recent
,--here
옵션은 동시에 사용할 수 없습니다.
작업 공간 우선순위 규칙
작업 공간을 명시적으로 지정하지 않으면 comfy-cli는 다음 우선순위에 따라 자동으로 선택합니다:
comfy set-default <path>
로 지정된 기본 ComfyUI 경로- 가장 최근에 실행되거나 설치된 ComfyUI
- 현재 디렉토리의 ComfyUI
실용적인 사용 예시
시나리오 1: 다른 프로젝트를 위한 독립적인 환경 생성
# 프로젝트 A용 작업 공간 생성
comfy --workspace=~/projects/projectA install
# 프로젝트 B용 작업 공간 생성
comfy --workspace=~/projects/projectB install
# 프로젝트 A에 특정 노드 설치
comfy --workspace=~/projects/projectA node install ComfyUI-AnimateDiff-Evolved
# 프로젝트 B에 다른 노드 설치
comfy --workspace=~/projects/projectB node install ComfyUI-Impact-Pack
시나리오 2: 빠른 환경 전환
# 자주 사용하는 작업 공간을 기본값으로 설정
comfy set-default ~/projects/main-workspace
# 다른 작업 공간에서 임시로 작업
comfy --workspace=~/projects/test-workspace launch
# 기본 작업 공간으로 돌아가기
comfy launch
실행 옵션
ComfyUI는 다양한 요구사항을 충족하는 풍부한 실행 옵션을 제공합니다:
기본 실행
# 기본 실행
comfy launch
# 백그라운드에서 실행
comfy launch --background
# 백그라운드 인스턴스 중지
comfy stop
네트워크 구성
# 리스닝 주소와 포트 지정
comfy launch -- --listen 0.0.0.0 --port 8080
# 외부 접근 허용
comfy launch -- --listen 0.0.0.0
성능 최적화
# CPU 모드 사용
comfy launch -- --cpu
# 낮은 VRAM 모드
comfy launch -- --lowvram
# 매우 낮은 VRAM 모드
comfy launch -- --novram
# 모델 CPU 오프로딩 활성화
comfy launch -- --cpu-vae
사용자 정의 노드 관리
노드 정보 보기
# 사용 가능한 모든 노드 정보 표시
comfy node show all
# 설치된 노드의 간단한 표시
comfy node simple-show installed
# 활성화된 노드 표시
comfy node show enabled
# 설치되지 않은 노드 표시
comfy node show not-installed
# 비활성화된 노드 표시
comfy node show disabled
# 특정 채널의 노드 표시
comfy node show all --channel recent
노드 설치 및 업데이트
# 사용자 정의 노드 설치
comfy node install ComfyUI-Impact-Pack
# 모든 노드 업데이트
comfy node update all
# 특정 노드 업데이트
comfy node update ComfyUI-Impact-Pack
노드 스냅샷 관리
스냅샷 기능은 노드 구성 상태를 저장하고 복원하는 데 도움이 됩니다:
# 노드 스냅샷 저장
comfy node save-snapshot
# 스냅샷 목록 보기
comfy node show snapshot-list
# 노드 스냅샷 복원
comfy node restore-snapshot <snapshot_name>
의존성 관리
# 워크플로우 파일에서 의존성 설치
comfy node install-deps --workflow=workflow.json
# 워크플로우 PNG 파일에서 의존성 설치
comfy node install-deps --workflow=workflow.png
# 의존성 JSON 파일에서 설치
comfy node install-deps --deps=dependencies.json
# 워크플로우 의존성 파일 생성
comfy node deps-in-workflow --workflow=workflow.json --output=deps.json
노드 문제 해결 (Bisect)
노드 충돌이나 문제가 발생했을 때 bisect 기능을 사용하여 문제가 있는 노드를 빠르게 식별합니다:
# 문제 해결 세션 시작
comfy node bisect start
# 현재 상태를 양호로 표시
comfy node bisect good
# 현재 상태를 문제가 있는 것으로 표시
comfy node bisect bad
# 문제 해결 세션 재설정
comfy node bisect reset
모델 관리
모델 다운로드
# URL에서 모델 다운로드 (CivitAI, Hugging Face 등 지원)
comfy model download --url https://huggingface.co/model/url
# 지정된 상대 경로로 다운로드
comfy model download --url https://civitai.com/api/download/models/123456 --relative-path models/checkpoints
# CivitAI API 토큰 설정 (로그인 필요 모델 다운로드용)
comfy model download --url https://civitai.com/api/download/models/123456 --set-civitai-api-token YOUR_TOKEN
# 여러 옵션 결합
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints
모델 관리
# 기본 경로의 모든 모델 나열
comfy model list
# 지정된 경로의 모델 나열
comfy model list --relative-path models/loras
# 지정된 모델 제거
comfy model remove --model-names "model1.safetensors,model2.ckpt"
# 지정된 경로에서 모델 제거
comfy model remove --relative-path models/checkpoints --model-names "old_model.ckpt"
지원되는 모델 소스
- Hugging Face: 직접 파일 URL 사용
- CivitAI: 모델 다운로드 API URL 사용
- 기타 직접 링크: 직접 다운로드 가능한 모델 파일 URL
ComfyUI-Manager 관리
comfy-cli는 ComfyUI-Manager 설정도 관리할 수 있습니다:
# ComfyUI-Manager GUI (메뉴 및 서버) 비활성화
comfy manager disable-gui
# ComfyUI-Manager GUI 활성화
comfy manager enable-gui
# 예약된 시작 작업 지우기
comfy manager clear
환경 정보
현재 ComfyUI 환경에 대한 자세한 정보 보기:
# 실행 상태, 작업 공간 등을 포함한 환경 정보 표시
comfy env
# 추적 설정 상태 확인
comfy tracking status
# 사용량 추적 비활성화
comfy tracking disable
# 사용량 추적 활성화
comfy tracking enable
고급 기능
베타 기능: comfy-lock.yaml
comfy-cli는 comfy-lock.yaml
파일을 사용한 프로젝트 의존성 관리를 지원합니다:
basic:
models:
- model: [모델 이름]
url: [모델 소스 URL, 예: https://huggingface.co/...]
paths: [모델 경로 목록]
- path: [모델 경로]
- path: [모델 경로]
hashes: [모델 해시]
- hash: [해시 값]
type: [AutoV1, AutoV2, SHA256, CRC32, Blake3]
type: [모델 유형, 예: diffuser, lora, etc.]
# ComfyUI-Manager .yaml 스냅샷과 호환
custom_nodes:
comfyui: [커밋 해시]
file_custom_nodes:
- disabled: [bool]
filename: [.py 파일명]
...
git_custom_nodes:
[git-url]:
disabled: [bool]
hash: [커밋 해시]
...
일반적인 사용 시나리오
개발 환경 관리
# 개발 환경 생성
comfy --workspace=~/dev/comfyui-dev install
# 테스트 환경 생성
comfy --workspace=~/test/comfyui-test install
# 개발 환경에 실험적 노드 설치
comfy --workspace=~/dev/comfyui-dev node install experimental-node
# 테스트를 위해 테스트 환경으로 빠르게 전환
comfy --workspace=~/test/comfyui-test launch
프로젝트 의존성 관리
# 프로젝트용 의존성 스냅샷 생성
comfy node save-snapshot project-v1.0
# 프로젝트 워크플로우 의존성 설치
comfy node install-deps --workflow=project-workflow.json
# 특정 버전 의존성으로 복원
comfy node restore-snapshot project-v1.0
자동화된 모델 관리
# 프로젝트에 필요한 모델 일괄 다운로드
comfy model download --url https://huggingface.co/model1 --relative-path models/checkpoints
comfy model download --url https://huggingface.co/model2 --relative-path models/loras
# 오래된 모델 정리
comfy model remove --model-names "old_model1.ckpt,old_model2.safetensors"
문제 해결
일반적인 문제
-
작업 공간 경로 문제
# 현재 작업 공간 확인 comfy which # 경로가 올바르지 않은 경우 재설정 comfy set-default /correct/path
-
노드 충돌 문제
# bisect 기능을 사용하여 문제 위치 파악 comfy node bisect start # 프롬프트에 따라 정상/비정상 상태 표시
-
권한 문제
# 충분한 권한이 있는지 확인 ls -la ~/comfy