완전한 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