X에서 팔로우ComfyUI WikiComfyUI Wiki는 커뮤니티에서 개인적으로 관리하는 비공식 사이트입니다. ComfyUI 공식 문서 는 이 사이트와 별개의 공식 사이트입니다.

완전한 Comfy CLI 사용자 가이드

작업 공간 관리, 노드 관리, 모델 관리 및 기타 고급 기능을 포함한 모든 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

관련 링크

완전한 Comfy CLI 사용자 가이드 | ComfyUI Wiki