ComfyUI 설치는 저장소를 받고 pip install -r requirements.txt 후 python main.py를 실행하는 세 단계입니다. 저장소 자체는 62MB로 가볍고, 무거운 건 그다음에 깔리는 torch와 따로 받아야 하는 모델 파일입니다. 검색에 ‘설치 오류’와 ‘설치 경로’가 유독 많이 붙는 이유가 여기 있습니다.
설치 3단계
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python main.py가상환경을 먼저 만드는 게 중요합니다. ComfyUI는 torch, transformers, safetensors 등을 끌고 오는데 시스템 파이썬에 바로 깔면 다른 프로젝트와 버전이 충돌합니다. 가상환경이 익숙하지 않다면 파이썬 가상환경과 CUDA 확인을 먼저 보십시오.
requirements.txt에 실제로 들어 있는 주요 항목입니다.
- 핵심
- torch, torchvision, torchsde
- 모델 로딩
- transformers, tokenizers, safetensors, sentencepiece
- 수치 연산
- numpy, scipy, einops
- 서버
- aiohttp, yarl, alembic
- 프런트엔드
- comfyui-frontend-package (버전 고정)
설치 경로 — 어디에 뭐가 들어가나
가장 많이 묻는 게 모델을 어디에 넣느냐입니다. 저장소 안의 models/ 아래에 종류별 폴더가 미리 만들어져 있고, 거기에 맞춰 넣어야 노드가 인식합니다.
| 폴더 | 넣는 것 |
|---|---|
models/checkpoints |
통합 체크포인트 파일 |
models/diffusion_models |
디퓨전 모델 단독 가중치 |
models/clip · clip_vision |
텍스트·이미지 인코더 |
models/controlnet |
컨트롤넷 가중치 |
models/embeddings |
임베딩(텍스추얼 인버전) |
모델을 저장소 바깥이나 잘못된 하위 폴더에 두면 노드 목록에 안 뜹니다. 오류 메시지가 아니라 그냥 선택지가 비어 있게 나와서 설치 실패로 오해하기 쉽습니다. 경로를 바꾸고 싶으면 --base-directory 인자로 지정하십시오.
자주 나는 오류와 원인
| 증상 | 실제 원인 | 대응 |
|---|---|---|
| ModuleNotFoundError | 가상환경 미활성화 | activate 후 재설치 |
| 노드에 모델이 안 보임 | models 하위 폴더 불일치 | 종류별 폴더 확인 |
| 실행 중 메모리 부족 | VRAM 초과 | --lowvram 또는 --novram |
| GPU를 안 씀 | CPU 빌드 torch | torch.version.cuda 확인 |
| 포트 충돌 | 다른 서버가 점유 | --port 변경 |
메모리 관련 인자가 특히 유용합니다. --lowvram은 모델을 쪼개 올려 VRAM을 아끼고, --novram은 더 공격적으로 내립니다. GPU가 아예 없으면 --cpu로도 돌아가지만 생성 속도가 수십 배 느려집니다.
VRAM은 얼마나 필요한가
이미지 생성은 LLM과 메모리 성격이 다릅니다. 가중치보다 해상도와 배치 크기가 사용량을 좌우합니다.
같은 모델이라도 : 512px < 1024px < 배치 4장
부족하면 → –lowvram 또는 해상도·배치 축소
8GB면 기본 해상도로는 돌아가지만 고해상도나 다중 배치에서 바로 막힙니다. 12GB 이상이면 여유가 생기고, 16GB 이상이면 대부분의 워크플로를 신경 쓰지 않고 돌릴 수 있습니다. 내 카드 용량 확인은 VRAM 기준표를 참고하십시오.
AMD와 맥에서도 되나
됩니다. 저장소 설명에 AMD(ROCm) 안내와 Apple Silicon 항목이 따로 있습니다. 다만 엔비디아 경로가 기본이고 나머지는 추가 설정이 필요합니다. ROCm 쪽은 nightly 빌드를 쓰라는 안내가 많아 안정성보다 최신 버전을 따라가야 하는 구조라고 보시면 됩니다.
자주 묻는 질문
ComfyUI 설치 용량은 얼마나 되나요?
저장소 자체는 62MB입니다. 여기에 torch 등 의존성과 모델 파일이 더해져 실제로는 수십 GB가 됩니다.
설치했는데 모델이 목록에 안 뜹니다.
대부분 models/ 하위 폴더가 종류와 맞지 않아서입니다. 체크포인트는 checkpoints, 컨트롤넷은 controlnet처럼 정해진 폴더에 넣어야 합니다.
VRAM이 부족하다는 오류가 납니다.
--lowvram으로 실행하거나 해상도와 배치를 줄이십시오. 그래도 안 되면 --cpu가 있지만 매우 느립니다.
가상환경 없이 설치해도 되나요?
가능하지만 권하지 않습니다. torch 버전이 다른 프로젝트와 충돌하면 양쪽 다 고장납니다.
답글 남기기