메인 콘텐츠로 건너뛰기
이 가이드에서는 ComfyUI를 설치하기 위한 시스템 요구사항을 소개합니다. ComfyUI는 수시로 업데이트되기 때문에 이 문서가 최신 상태로 유지되지 않을 수 있습니다. 관련 지침은 ComfyUI를 참조해 주세요. 어떤 버전의 ComfyUI를 사용하든, ComfyUI는 별도의 Python 환경에서 실행됩니다.

시스템 요구사항

현재 다음과 같은 운영체제를 지원합니다:
  • Windows
  • Linux
  • macOS (M 시리즈와 같은 Apple Silicon 지원)
다음 섹션들을 참고하여 다양한 시스템과 ComfyUI 버전별 설치 방법을 알아보세요. 각 버전의 설치 과정에서 간단히 시스템 요구사항을 설명했습니다.
ComfyUI Desktop currently supports standalone installation for Windows and MacOS (ARM), currently in Beta
  • Code is open source on Github
Because Desktop is always built based on the stable release, so the latest updates may take some time to experience for Desktop, if you want to always experience the latest version, please use the portable version or manual installation
You can choose the appropriate installation for your system and hardware below

ComfyUI Desktop (Windows) Installation Guide

Suitable for Windows version with Nvidia GPU
Portable version is a ComfyUI version that integrates an independent embedded Python environment, using the portable version you can experience the latest features, currently only supports Windows system

ComfyUI Portable (Windows) Installation Guide

Supports Windows ComfyUI version running on Nvidia GPUs or CPU-only, always use the latest commits and completely portable.

ComfyUI Manual Installation Guide

Supports all system types and GPU types (Nvidia, AMD, Intel, Apple Silicon, Ascend NPU, Cambricon MLU)

Python 버전

  • Python 3.13은 매우 잘 지원되며 권장됩니다.
  • Python 3.14도 작동하지만 일부 커스텀 노드에서 문제가 발생할 수 있습니다. 무료 스레드 변형은 작동하지만 일부 종속성이 GIL을 활성화하므로 완벽히 지원되지는 않습니다.
  • Python 3.12는 3.13에서 일부 커스텀 노드 종속성 문제를 겪을 경우 좋은 대안입니다.

브라우저 요구사항

최상의 경험을 위해 Google Chrome 버전 143 이상을 사용하세요. 이전 버전의 Chrome(142 이하)에서는 ComfyUI에서 시각적 오류와 성능 문제가 발생하는 것으로 알려져 있습니다.

지원되는 하드웨어

  • NVIDIA GPU - CUDA 13.0과 함께 안정적인 PyTorch 설치: pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
  • AMD GPU (Linux) - ROCm 7.2 안정판 또는 Nightly 버전
  • AMD GPU (Windows/Linux, RDNA 3/3.5/4만 해당) - RX 7000 시리즈(RDNA 3), Strix Halo/Ryzen AI Max+ 365(RDNA 3.5), RX 9000 시리즈(RDNA 4) 실험적 지원
  • Intel GPU - Arc 시리즈, 기본 PyTorch torch.xpu 지원
  • Apple Silicon - M1/M2/M3/M4 시리즈, Metal 가속 지원
  • Ascend NPU - torch_npu 확장자를 통해
  • Cambricon MLU - torch_mlu 확장자를 통해
  • Iluvatar Corex - PyTorch용 Iluvatar 확장을 통해
  • CPU - --cpu 파라미터 사용(느리지만 가능)
자세한 설치 단계는 ComfyUI Windows 및 Linux 수동 설치 섹션을 참조해 주세요.
PyTorch 2.4 이상도 지원되지만, 일부 기능과 최적화는 최신 버전에서만 작동할 수 있습니다. 일반적으로 PyTorch의 최신 메이저 버전과 최신 CUDA 버전을 사용하는 것이 좋습니다. 단, 출시된 지 2주 미만인 경우는 제외됩니다.현재 Windows 포터블 빌드에는 Python 3.13과 PyTorch CUDA 13.0이 포함되어 있습니다. 만약 시작되지 않는다면 NVIDIA 드라이버를 업데이트해 주세요.

종속성

  • PyTorch 설치(하드웨어에 맞는 버전)
  • ComfyUI의 requirements.txt에 있는 모든 종속성 설치: pip install -r requirements.txt

수동 설치

자세한 설치 단계는 수동 설치 섹션을 참조해 주세요.