Skip to content
Merged
29 changes: 17 additions & 12 deletions installation/system_requirements.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,33 +25,38 @@ You can refer to the following sections to learn about the installation methods

### Python Version

- Recommended Python 3.12
- Supports Python 3.13 (some custom nodes may not be compatible)
- **Python 3.13** is very well supported and recommended
- Python 3.14 works but you may encounter issues with the torch compile node
- Python 3.12 is a good fallback if you have trouble with some custom node dependencies on 3.13

### Browser Requirements

For the best experience, use **Google Chrome version 143 or later**. Earlier versions of Chrome (142 and below) have known issues that can cause visual glitches and performance problems in ComfyUI.

### Supported Hardware

- NVIDIA GPU
- AMD GPU
- Intel GPU (includes Arc series, supports IPEX)
- Apple Silicon (M1/M2)
- Ascend NPU
- Cambricon MLU
- CPU (can use the --cpu parameter, slower)
- **NVIDIA GPU** - Install stable pytorch with CUDA 13.0: `pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130`
- **AMD GPU (Linux)** - ROCm 6.4 stable or ROCm 7.1 nightly
- **AMD GPU (Windows/Linux, RDNA 3/3.5/4 only)** - Experimental support for RX 7000 series (RDNA 3), Strix Halo/Ryzen AI Max+ 365 (RDNA 3.5), and RX 9000 series (RDNA 4)
- **Intel GPU** - Arc series with native PyTorch torch.xpu support
- **Apple Silicon** - M1/M2/M3/M4 series with Metal acceleration
- **Ascend NPU** - Via torch_npu extension
- **Cambricon MLU** - Via torch_mlu extension
- **Iluvatar Corex** - Via Iluvatar Extension for PyTorch
- **CPU** - Use the `--cpu` parameter (slower)

Please refer to the [ComfyUI Windows and Linux manual installation section](https://github.com/comfyanonymous/ComfyUI?tab=readme-ov-file#manual-install-windows-linux) for detailed installation steps.

<Note>
The stable version of PyTorch 2.7 now supports the Blackwell architecture (CUDA 12.8), and the core and desktop versions of ComfyUI have adopted this version.
PyTorch 2.4 and above is supported, but some features and optimizations might only work on newer versions. We generally recommend using the latest major version of PyTorch with the latest CUDA version unless it is less than 2 weeks old.

The Windows portable build currently comes with Python 3.13 and PyTorch CUDA 13.0. Update your Nvidia drivers if it doesn't start.
</Note>

### Dependencies

- Install PyTorch
- Install all dependencies in the requirements.txt of ComfyUI
- Install PyTorch (version specific to your hardware)
- Install all dependencies in the requirements.txt of ComfyUI: `pip install -r requirements.txt`

<Card title="Manual Installation" icon="book" href="/installation/manual_install">
Please refer to the manual installation section for detailed installation steps.
Expand Down
31 changes: 19 additions & 12 deletions zh-CN/installation/system_requirements.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,32 +25,39 @@ import InstallLink from "/snippets/zh/install/install-link.mdx"
<InstallLink/>

### Python 版本
- 推荐 Python 3.12
- 支持 Python 3.13(部分自定义节点可能不兼容)

- **Python 3.13** 支持良好,推荐使用
- Python 3.14 可用,但 torch compile 节点可能存在问题
- 如果某些自定义节点在 3.13 上有依赖问题,Python 3.12 是一个不错的备选

### 浏览器要求

为获得最佳体验,请使用 **Google Chrome 143 或更高版本**。Chrome 142 及更早版本存在已知问题,可能导致 ComfyUI 出现视觉故障和性能问题。

### 支持的硬件
- NVIDIA 显卡
- AMD 显卡
- Intel 显卡(包括 Arc 系列,支持 IPEX)
- Apple Silicon(M1/M2)
- Ascend NPU
- Cambricon MLU
- CPU(可用 --cpu 参数,速度较慢)

- **NVIDIA 显卡** - 安装稳定版 PyTorch(CUDA 13.0):`pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130`
- **AMD 显卡(Linux)** - ROCm 6.4 稳定版或 ROCm 7.1 nightly 版
- **AMD 显卡(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 显卡** - Arc 系列,原生支持 PyTorch torch.xpu
- **Apple Silicon** - M1/M2/M3/M4 系列,支持 Metal 加速
- **Ascend NPU** - 通过 torch_npu 扩展
- **Cambricon MLU** - 通过 torch_mlu 扩展
- **Iluvatar Corex** - 通过 Iluvatar Extension for PyTorch
- **CPU** - 使用 `--cpu` 参数(速度较慢)

请参考[ComfyUI Windows 和 Linux 手动安装章节](https://github.com/comfyanonymous/ComfyUI?tab=readme-ov-file#manual-install-windows-linux)了解详细的安装步骤。

<Note>
目前稳定版本的 PyTorch 2.7 已经支持 Blackwell 架构(CUDA 12.8),ComfyUI 的核心版本和桌面版本已经采用了这个版本。
支持 PyTorch 2.4 及以上版本,但某些功能和优化可能仅在较新版本上可用。我们通常建议使用最新主要版本的 PyTorch 和最新 CUDA 版本,除非发布时间不足两周。

Windows 便携版目前附带 Python 3.13 和 PyTorch CUDA 13.0。如果无法启动,请更新您的 Nvidia 驱动程序。
</Note>

### 依赖

- 需安装 PyTorch(不同硬件需不同版本,详见下方
- 需安装 ComfyUI 的 requirements.txt 中所有依赖
- 安装 PyTorch(根据您的硬件选择对应版本
- 安装 ComfyUI 的 requirements.txt 中所有依赖:`pip install -r requirements.txt`

<Card title="Manual Installation" icon="book" href="/zh-CN/installation/manual_install">
请参考手动安装章节了解详细的安装步骤。
Expand Down