> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 시스템 요구사항

> ComfyUI 설치 및 실행을 위한 하드웨어 및 소프트웨어 요구 사항.

이 가이드에서는 ComfyUI를 설치하기 위한 시스템 요구사항을 소개합니다. ComfyUI는 수시로 업데이트되기 때문에 이 문서가 최신 상태로 유지되지 않을 수 있습니다. 관련 지침은 [ComfyUI](https://github.com/Comfy-Org/ComfyUI)를 참조해 주세요.

어떤 버전의 ComfyUI를 사용하든, ComfyUI는 별도의 Python 환경에서 실행됩니다.

### 지원되는 운영체제

현재 다음과 같은 운영체제를 지원합니다:

* Windows
* Linux
* macOS (M 시리즈와 같은 Apple Silicon 지원)

각 운영체제 및 설정에 맞는 설치 지침은 아래 링크를 참조하세요.

<AccordionGroup>
  <Accordion title="Comfy 데스크톱">
    Comfy 데스크톱은 현재 \*\*Windows 및 MacOS (ARM)\*\*용 독립형 설치를 지원하며, 현재 베타 버전입니다.

    * 코드는 [Github](https://github.com/Comfy-Org/desktop)에서 오픈소스로 제공됩니다.

    <Tip>
      데스크톱은 항상 **안정적인 릴리스**를 기반으로 구축되기 때문에, 최신 업데이트를 바로 경험하기까지 다소 시간이 걸릴 수 있습니다. 항상 최신 버전을 경험하고 싶다면 휴대용 버전이나 수동 설치 방법을 사용해 주세요.
    </Tip>

    아래에서 시스템과 하드웨어에 맞는 적절한 설치 방법을 선택할 수 있습니다.

    <Tabs>
      <Tab title="Windows">
        <Card title="Comfy 데스크톱 (Windows) 설치 가이드" icon="link" href="/ko/installation/desktop/windows">
          **Windows** 버전에서 **Nvidia** GPU를 사용하는 경우에 적합합니다.
        </Card>
      </Tab>

      <Tab title="MacOS(애플 실리콘)">
        <Card title="Comfy 데스크톱 (MacOS) 설치 가이드" icon="link" href="/ko/installation/desktop/macos">
          **애플 실리콘**을 탑재한 MacOS에 적합합니다.
        </Card>
      </Tab>

      <Tab title="Linux">
        <Note>Comfy 데스크톱은 현재 **Linux용 사전 빌드가 없습니다**, [수동 설치](/ko/installation/manual_install) 섹션을 방문하여 ComfyUI를 설치해 주세요.</Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="ComfyUI 휴대용 (Windows)">
    휴대용 버전은 독립적인 임베디드 파이썬 환경을 통합한 ComfyUI 버전으로, 휴대용 버전을 사용하면 최신 기능을 경험할 수 있습니다. 현재 **Windows** 시스템만 지원합니다.

    <Card title="ComfyUI 휴대용 (Windows) 설치 가이드" icon="link" href="/ko/installation/comfyui_portable_windows">
      **Windows** ComfyUI 버전이 **Nvidia GPU** 또는 **CPU 전용**으로 실행되며, 항상 최신 커밋을 사용하고 완벽히 휴대 가능합니다.
    </Card>
  </Accordion>

  <Accordion title="수동 설치">
    <Card title="ComfyUI 수동 설치 가이드" icon="link" href="/ko/installation/manual_install">
      모든 시스템 유형 및 GPU 유형(Nvidia, AMD, Intel, 애플 실리콘, Ascend NPU, Cambricon MLU)을 지원합니다.
    </Card>
  </Accordion>
</AccordionGroup>

### 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 수동 설치 섹션](https://github.com/Comfy-Org/ComfyUI?tab=readme-ov-file#manual-install-windows-linux)을 참조해 주세요.

<Note>
  PyTorch 2.4 이상도 지원되지만, 일부 기능과 최적화는 최신 버전에서만 작동할 수 있습니다. 일반적으로 PyTorch의 최신 메이저 버전과 최신 CUDA 버전을 사용하는 것이 좋습니다. 단, 출시된 지 2주 미만인 경우는 제외됩니다.

  현재 Windows 포터블 빌드에는 Python 3.13과 PyTorch CUDA 13.0이 포함되어 있습니다. 만약 시작되지 않는다면 NVIDIA 드라이버를 업데이트해 주세요.
</Note>

### 의존성

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

<Card title="수동 설치" icon="book" href="/ko/installation/manual_install">
  자세한 설치 단계는 수동 설치 섹션을 참조해 주세요.
</Card>