Skip to content
더 나은 ComfyUI 지식베이스 구축을 돕기 후원자 되기

완전한 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는 다음 우선순위에 따라 자동으로 선택합니다:

  1. comfy set-default <path>로 지정된 기본 ComfyUI 경로
  2. 가장 최근에 실행되거나 설치된 ComfyUI
  3. 현재 디렉토리의 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"

문제 해결

일반적인 문제

  1. 작업 공간 경로 문제

    # 현재 작업 공간 확인
    comfy which
     
    # 경로가 올바르지 않은 경우 재설정
    comfy set-default /correct/path
  2. 노드 충돌 문제

    # bisect 기능을 사용하여 문제 위치 파악
    comfy node bisect start
    # 프롬프트에 따라 정상/비정상 상태 표시
  3. 권한 문제

    # 충분한 권한이 있는지 확인
    ls -la ~/comfy

관련 링크