ComfyUI 설치 및 실행 방법 | 수동 설치

스테이블 디퓨젼 (StableDiffusion)을 이용해 그림을 생성하는 대표적인 UI 중 하나인 ComfyUI 설치 방법에 대해 살펴보도록 하겠습니다.

ComfyUI 설치 방법

ComfyUI 설치 절차

ComfyUI는 오픈소스로 끊임없이 개발과 업데이트가 이뤄지고 있는 프로그램답게 Github에서 바로 내려받아(git clone) 수동으로 설치 할 수 있습니다. 수동 설치가 어려운 분들은 ComfyUI 깃허브 페이지에서 압축파일 형태로 바로 내려받아 압축 해제 후 실행 가능한 자동설치 파일을 이용할 수도 있습니다. 본 포스팅에서는 두 가지 방법 모두 살펴보도록 하겠습니다.

ComfyUI 전체 설치 절차

ComfyUI 설치 방법은 수동 또는 자동으로 크게 2가지로 구분할 수 있습니다. 단, 두 방법모두 ComfyUI 설치에 앞서 파이썬과 Git 설치가 선행되어야 합니다. 파이썬의 경우 경로설정(환경변수)까지 정확히 해주셔야 하며, Git의 경우 설치 프로그램의 안내에 따라 설치만 정확히 해주셔도 큰 문제가 없습니다. 구체적인 파이썬, Git 설치에 대해서는 다른 포스팅에서 다로도록 하고, 본문에서는 본격적으로 ComfyUI 설치 방법에 대해 자세히 살펴보겠습니다.

ComfyUI 수동 설치 방법

먼저 깃허브 레포(repository)를 수동으로 내려받아 설치 및 실행하는 방법에 대해 살펴보도록 하겠습니다.

ComfyUI 수동 설치 절차

ComfyUI 수동 설치 절차를 살펴보면 크게 7단계로 다음과 같습니다.

  1. ComfyUI Github 페이지 접속
  2. Git clone
  3. Checkpoint, VAE 복사
  4. 가상환경(venv) 설정
  5. pytorch 설치
  6. Dependencies 설치
  7. 실행

아래에서는 각 단계별로 차근차근 자세히 살펴보도록 하겠습니다.

ComfyUI 깃허브 페이지 접속

ComfyUI의 깃허브 주소는 다음과 같습니다. 주소를 직접 입력하거나 또는 링크를 통해 ComfyUI 깃허브 페이지로 이동합니다.

https://github.com/comfyanonymous/ComfyUI

Git clone

이제 ComfyUI를 내려받는 단계입니다. 깃허브 페이지에서 아래 그림을 참고하여 Git repository 주소를 복사합니다. 보통 깃주소는 위와 같이 깃허브 페이지의 주소 뒤에 .git이 추가된 형태입니다.

https://github.com/comfyanonymous/ComfyUI.git

이제 내 컴퓨터에 설치하고자 하는 폴더를 만든 뒤 아래와 같이 해당 폴더에서 터미널을 열어줍니다.

본 예시에서는 테스트를 위해 바탕화면에 comfyui_cloning이란 폴더를 만들고 해당 폴더에서 터미널을 실행했습니다. 맥 또는 윈도우 환경에서 터미널을 실행하고 폴더를 이동하는 방법을 모르시는 분들은 아래를 참고해주시기 바랍니다.

이제 ComfyUI 깃허브 Repository를 위 폴더에 통째로 복사(clone)하기 위해 아래 명령어를 입력합니다.

git clone https://github.com/comfyanonymous/ComfyUI.git

명령어 입력 후 엔터를 입력하면 수 초 내로 아래와 같이 해당 폴더에 ComfyUI라는 새로운 폴더가 생성됩니다.

ComfyUI 폴더를 열어보면 아래와 같이 ComfyUI 깃허브 페이지에서 볼 수 있었던 모든 폴더 및 파일(일부 파일 및 폴더는 숨김처리 되어 있음)들이 동일하게 복사된 것을 확인할 수 있습니다.

Checkpoint/VAE 복사

스테이블 디퓨젼으로 그림을 생성하기 위해서는 그림이 이미 학습된 모델(Checkpoint), 노이즈 이미지로부터 확산(diffusion) 이미지를 생성하는 VAE라는 파일이 필수적으로 필요합니다. 모델 및 VAE을 다운로드 받는 방법 및 각각에 대한 자세한 내용은 다른 포스팅에서 더욱 구체적으로 다루도록 하겠습니다.

여기서는 설치 및 실행이 중요하므로, 아래 예시 모델과 VAE를 다운받아 각각의 위치로 이동시켜줍니다. 만약 실사만 생성하고 싶다면 실사모델과 실사VAE를 다운받으면 됩니다.

구분다운로드 페이지 링크
실사모델majicMIX realistic
그림모델anything
실사VAEvae-ft-mse-840000-ema
그림VAEKI-f8-anime
*모델1개 VAE1개는 필수 다운로드 추가는 다운로드는 자유

모델 및 VAE 파일의 확장자는 .safetensors 또는 .ckpt입니다. 같은 모델을 둘 중 어떤 확장자로 받더라도 실제 그림을 생성할 때는 동일하게 동작하지만, 많은 분들이 보안상의 이유로 .safetensors 확장자 파일을 선호하고 있습니다. 다운받은 모델과 VAE는 각각 ComfyUI > models의 checkpoints, vae 폴더에 넣습니다.

가상환경 설정

모델과 VAE까지 다운로드를 마쳤다면 이제 그림을 그릴 화가가 준비가 되었습니다. 이제 ComfyUI를 통해 이 화가가 실제로 그림을 그려내기 위한 실행 환경인 화방(venv 가상환경)을 구성해줘야 합니다.

화방에 해당하는 이 가상환경은 내 컴퓨터 내 어디에 구축해도 상관없지만, 본 예제에서는 우리의 편의를 위해 ComfyUI 폴더 내에 구축해보도록 하겠습니다. ComfyUI 폴더에서 터미널을 실행한 뒤 아래와 같이 명령어를 입력해서 가상환경을 생성합니다.

Windows

python -m venv virtualenv

MacOS

python3 -m venv virtualenv

윈도우와 맥에서 파이썬(python)을 불러오는 명령어에 조금 차이가 있지만 실제 가상환경을 구축하는 명령어는 동일합니다. 명령어의 의미를 간략히 살펴보면 다음과 같습니다.

  • python/python3 : 파이썬을 실행
  • -m : make
  • venv : 가상환경(virtual environment)을 만들어라
  • virtualenv : 가상환경 폴더 이름(입력한 단어로 가상환경 폴더 생성됨)

예시에서는 이제 virtualenv라는 이름을 가진 가상환경 폴더, 즉 화방이 구축된 것을 확인할 수 있습니다. 가상환경은 사용자의 의도에 따라 여러개를 만들어 사용하는 것도, 이미 구축된 환경을 삭제하는 것도 가능합니다. 가상환경에 대한 자세한 내용은 다른 포스팅에서 다루도록 하겠습니다.

이제 ComfyUI 실행을 위해 설치한 모든것들은 이 가상환경을 활성화 한 후에 실행해줘야 합니다. 가상환경은 아래와 같은 명령어로 활성화할 수 있습니다.

Windows

가상환경폴더명/scripts/activate

MacOS

source 가상환경폴더명/bin/activate

본 예시에서는 macOS에서 가상환경 폴더명을 virtualenv로 만들었기 때문에, source virtualenv/bin/activate라고 입력하여 위와 같이 가상환경에 진입(위 그림과 같이 윈도우/맥 모두 가상환경에 진입하면, 터미널 상 가상화면 진입여부를 나타내는 표식이 나타납니다.)한 것을 확인할 수 있습니다.

만약 가상환경이 활성화 된 상태에서 빠져나오고 싶은 경우 위 그림과 같이 간단히 deactivate를 입력하면 됩니다.

pytorch 설치

이제 화가가 그림을 그리기 위해 화방(가상환경)에 도구들을 채워넣어줘야 합니다. 가장 먼저 pytorch라는 도구를 설치하기 위해 아래 명령어를 입력(명령어 중간에 –extra-index-url 입력시 하이픈2개 주의)합니다. 이때 반드시 가상환경이 활성화 된 상태인 것을 확인하고 아래 명령어를 입력해 설치해야 합니다. 가상환경이 올바로 구성되고 활성화되어 있다면, 해당 가상화면 폴더에 설치가 됩니다.

pip install torch torchvision torchaudio –extra-index-url https://download.pytorch.org/whl/cu121

*** 가상환경이 활성화 된 상태에서 입력합니다.

Dependencies 설치

마찬가지로 위에서 pytorch 설치가 정상적으로 마무리 되었다면 이번에는 가상환경에 각종 라이브러리를 설치해야 합니다. 처음 git clone을 통해 내려받은 프로젝트 내에 reqirements.txt 파일에 설치가 필요한 라이브러리 목록과 버전이 모두 적혀있습니다. 모든 라이브러리를 일괄 설치하기 위해 이번에는 아래 명령어를 입력합니다.

pip install -r requirements.txt

*** 가상환경이 활성화 된 상태에서 입력합니다.

실행

이제 모든 설치가 마무리 되었습니다. ComfyUI를 실행하기 위해서 가성환경이 활성화 된 상태에서 아래 명령어(ComfyUI 폴더 내에 위치한 main.py 파이썬 스크립트를, 우리가 구성한 가상환경 세팅으로 실행하라는 명령어)를 입력하면 로컬서버가 실행됩니다.

Windows

python main.py

MacOS

python3 main.py

서버가 실행되면 로컬호스트의 8188 포트로 접속해주시면 됩니다. 보통 로컬 호스트는 127.0.0.1이므로 서버 실행 상태 후 아무 웹브라우저 상 127.0.0.1:8188 또는 localhost:8188로 접속하면 ComfyUI가 정상적으로 실행됩니다.

ComfyUI 자동 설치 방법

터미널을 이용하여 수동으로 설치하는 것이 복잡하고 어려우신 분들께서는 Portable Windows 버전으로 압축파일을 내려받아 간단하게 설치하는 방법이 있습니다. 자동으로 ComfyUI 설치를 진행하는 경우 단순히 압축파일을 다운로드한 뒤 압축 해제만 하면 바로 실행 가능합니다.

우선 ComfyUI 설치에 앞서 파이썬과 Git은 설치를 먼저 마친 상태여야 합니다. 이후 본격적인 ComfyUI 설치를 위해 깃허브 페이지로 이동한 뒤 스크롤을 아래로 조금 내리면 아래와 같이 Installing이라고 적힌 부분을 발견할 수 있습니다.

portable windows 버전 ComfyUI 설치

“Direct link to download”를 클릭하면 압축파일을 다운로드 받을 수 있습니다. 해당 파일을 설치를 원하는 폴더에서 압축해제한 뒤, 모델과 VAE를 다운받아 각각 ComfyUI/models/checkpoints, ComfyUI/models/vae 폴더에 옯겨줍니다. 이후 ComfyUI 폴더 내에 위치한 “run_nvidia_gpu.bat” 파일을 실행해주시면 됩니다.