Comfy CLI 문제 해결 가이드

Comfy CLI의 대부분의 문제는 필수 요구 사항이 빠졌거나 설정 단계를 건너뛰어서 발생합니다. 문제를 보고하기 전에 아래 항목을 순서대로 확인하세요.

사전 요구사항

Comfy CLI를 사용하려면 시스템에 git이 설치되어 있어야 합니다. 먼저 git을 설치해야 comfy install과 comfy update가 ComfyUI와 커스텀 노드를 복제할 수 있습니다.

comfy install은 현재 활성화된 Python 환경에 ComfyUI를 설치하며, Python 3.9 이상이 필요합니다. 먼저 가상 환경을 만들고 활성화하세요:

python3 -m venv comfy-env
source comfy-env/bin/activate
comfy install

comfy install은 CUDA나 ROCm을 설치하지 않습니다. 실행하기 전에 하드웨어에 맞는 GPU 라이브러리를 설치하세요. 설치하지 않으면 comfy launch로 시작한 ComfyUI가 GPU를 사용할 수 없습니다.

comfy setup은 브라우저로 로그인하므로 CI, devcontainer, 헤드리스 서버에서는 완료할 수 없습니다. 대신 API 키를 전달하고 비대화형 모드로 실행하세요:

comfy setup --where cloud --api-key comfyui-... --non-interactive