Linux에서 ComfyUI 설치 방법
Linux에서 ComfyUI를 설치하는 주요 방법은 두 가지입니다:
- Comfy CLI를 사용한 설치 (권장) - 가장 간단하고 빠른 방법
- ComfyUI 소스 코드로부터 설치 - 전통적인 수동 설치 방법
이 튜토리얼은 Comfy CLI 설치를 권장하면서 두 설치 방법 모두를 자세히 다룹니다.
방법 1: Comfy CLI를 사용한 ComfyUI 설치 (권장)
Comfy CLI는 ComfyUI에서 제공하는 공식 명령줄 도구로, ComfyUI 설치 및 관리 프로세스를 크게 단순화합니다.
단계 1: 시스템 환경 준비
1. Python 환경 확인
ComfyUI는 Python 3.9 이상이 필요합니다. Python 버전을 확인하세요:
python3 --version
Python이 설치되지 않았거나 버전이 너무 낮은 경우 다음 단계를 따라 설치하세요:
Ubuntu/Debian 시스템:
sudo apt update
sudo apt install python3 python3-pip python3-venv
CentOS/RHEL/Fedora 시스템:
# CentOS/RHEL
sudo yum install python3 python3-pip
# 또는 Fedora
sudo dnf install python3 python3-pip
Arch Linux:
sudo pacman -S python python-pip
2. Git 설치 (설치되지 않은 경우)
# Ubuntu/Debian
sudo apt install git
# CentOS/RHEL
sudo yum install git
# Fedora
sudo dnf install git
# Arch Linux
sudo pacman -S git
3. 가상 환경 생성 (권장)
가상 환경을 사용하면 패키지 충돌 문제를 피할 수 있습니다:
# comfy-env라는 이름의 가상 환경 생성
python3 -m venv comfy-env
# 가상 환경 활성화
source comfy-env/bin/activate
참고: ComfyUI를 사용하기 전에 매번 가상 환경을 활성화해야 합니다. 가상 환경을 종료하려면
deactivate
명령을 사용하세요.
단계 2: Comfy CLI 설치
활성화된 가상 환경에서 comfy-cli를 설치합니다:
pip install comfy-cli
명령줄 자동 완성 구성 (선택사항)
더 나은 사용자 경험을 위해 명령줄 자동 완성을 활성화할 수 있습니다:
comfy --install-completion
단계 3: ComfyUI 설치
comfy-cli로 ComfyUI를 설치하는 것은 매우 간단하며, 하나의 명령만 필요합니다:
comfy install
이 명령은 다음을 수행합니다:
- ComfyUI의 최신 버전을 다운로드하고 설치
- ComfyUI-Manager (노드 관리자)를 자동으로 설치
- 기본 프로젝트 구조를 구성
설치 옵션
다음 옵션을 사용하여 설치를 사용자 정의할 수 있습니다:
# 기본 위치 ~/comfy에 설치
comfy install
# 지정된 디렉토리에 설치
comfy --workspace=/path/to/your/workspace install
# 현재 디렉토리의 기존 ComfyUI에서 작업 (주로 업데이트용)
comfy --here install
# 가장 최근에 실행되거나 설치된 ComfyUI에서 작업
comfy --recent install
# ComfyUI만 설치, ComfyUI-Manager 없이
comfy install --skip-manager
설치 경로 확인
다음 명령을 사용하여 현재 작업 공간을 확인할 수 있습니다:
# 기본 작업 공간 확인
comfy which
# 지정된 옵션의 작업 공간 확인
comfy --recent which
comfy --here which
단계 4: GPU 지원 설치
NVIDIA GPU (CUDA)
NVIDIA GPU를 사용하는 경우 CUDA 지원을 설치해야 합니다:
# CUDA 지원이 있는 PyTorch 설치
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu124
참고: CUDA 버전에 따라 해당하는 PyTorch 버전을 선택하세요. 최신 설치 명령은 PyTorch 웹사이트를 참조하세요.
AMD GPU (ROCm)
AMD GPU를 사용하는 경우:
# ROCm 지원이 있는 PyTorch 설치
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0
CPU만 사용
CPU만으로 실행하는 경우:
# CPU 버전의 PyTorch 설치
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
단계 5: ComfyUI 실행
설치가 완료된 후 ComfyUI를 실행합니다:
comfy launch
기본적으로 ComfyUI는 http://localhost:8188
에서 실행됩니다.
일반적인 실행 옵션
# 백그라운드에서 실행
comfy launch --background
# 리스닝 주소와 포트 지정
comfy launch -- --listen 0.0.0.0 --port 8080
# CPU 모드 사용
comfy launch -- --cpu
# 낮은 VRAM 모드
comfy launch -- --lowvram
# 백그라운드 인스턴스 중지
comfy stop
방법 2: ComfyUI 소스 코드로부터 설치
전통적인 설치 방법을 선호하는 경우 소스 코드로부터 직접 설치할 수도 있습니다:
1. ComfyUI 저장소 복제
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
2. 가상 환경 생성
python3 -m venv venv
source venv/bin/activate
3. 의존성 설치
pip install -r requirements.txt
4. GPU 지원 설치
GPU 유형에 따라 해당하는 PyTorch 버전을 설치합니다 (위의 단계 참조).
5. ComfyUI 실행
python main.py
설치 후 구성
기본 모델 설치
ComfyUI가 제대로 작동하려면 기본 모델이 필요합니다. 다음과 같이 할 수 있습니다:
- Hugging Face에서 모델 다운로드
- 모델 파일을
models/checkpoints/
디렉토리에 배치 - comfy-cli를 사용하여 다운로드:
comfy model download --url https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors --relative-path models/checkpoints
문제 해결
일반적인 문제
1. 권한 문제
권한 문제가 발생하는 경우 설치 디렉토리에 대한 충분한 쓰기 권한이 있는지 확인하세요:
# 기본 디렉토리를 사용하는 경우 ~/comfy 디렉토리가 쓰기 가능한지 확인
ls -la ~/comfy
2. Python 버전 문제
올바른 Python 버전을 사용하고 있는지 확인하세요:
python3 --version # 3.9 이상이어야 함
3. 네트워크 연결 문제
다운로드가 느린 경우 국내 미러 사용을 시도해보세요:
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple comfy-cli
4. GPU 감지 문제
GPU가 제대로 인식되는지 확인하세요:
import torch
print(torch.cuda.is_available()) # NVIDIA GPU
print(torch.version.cuda) # CUDA 버전
요약
Comfy CLI를 사용하는 것은 Linux에서 ComfyUI를 설치하는 최고의 방법으로, 다음을 제공합니다:
- 간단한 설치 프로세스: 하나의 명령으로 완전한 설치
- 완전한 의존성 관리: 모든 의존성을 자동으로 처리
- 다중 작업 공간 지원: 여러 ComfyUI 인스턴스를 관리할 수 있음
- 크로스 플랫폼 호환성: Windows, macOS, Linux에서 올바르게 작동
ComfyUI가 처음이라면 설치 및 관리에 Comfy CLI 사용을 강력히 권장합니다.
다음 단계
설치 후 다음을 할 수 있습니다:
- 📖 완전한 Comfy CLI 사용자 가이드를 확인하여 더 고급 기능을 학습
- 🎯 첫 번째 ComfyUI 워크플로우 시작
- 🔧 사용자 정의 노드 설치 및 관리
- 📦 모델 다운로드 및 관리