Skip to content
ComfyUI Wiki
더 나은 ComfyUI 지식베이스 구축을 돕기 후원자 되기
설치 가이드1. ComfyUI 설치1.4 리눅스에 ComfyUI 설치

Linux에서 ComfyUI 설치 방법

Linux에서 ComfyUI를 설치하는 주요 방법은 두 가지입니다:

  1. Comfy CLI를 사용한 설치 (권장) - 가장 간단하고 빠른 방법
  2. 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가 제대로 작동하려면 기본 모델이 필요합니다. 다음과 같이 할 수 있습니다:

  1. Hugging Face에서 모델 다운로드
  2. 모델 파일을 models/checkpoints/ 디렉토리에 배치
  3. 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 워크플로우 시작
  • 🔧 사용자 정의 노드 설치 및 관리
  • 📦 모델 다운로드 및 관리

관련 링크