From b2fc234331b64ac108d1692103b9ab2b4718e8d3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:35:23 +0000 Subject: [PATCH 01/82] Update installation/manual_install.mdx --- installation/manual_install.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/installation/manual_install.mdx b/installation/manual_install.mdx index d4992ea2..e0495352 100644 --- a/installation/manual_install.mdx +++ b/installation/manual_install.mdx @@ -18,6 +18,12 @@ For the installation of ComfyUI, it is mainly divided into several steps: 3. Install dependencies 4. Start ComfyUI + +Python 3.13 is very well supported. If you have trouble with some custom node dependencies on 3.13 you can try 3.12. + +Python 3.14 will work if you comment out the `kornia` dependency in the requirements.txt file (breaks the canny node) but it is not recommended. + + You can also refer to [ComfyUI CLI](/comfy-cli/getting-started) to install ComfyUI, it is a command line tool that can easily install ComfyUI and manage its dependencies. ## Create a virtual environment From c1fdc4f8a530ccb05927edf4d3392d966d076437 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:35:36 +0000 Subject: [PATCH 02/82] Update snippets/amd-install.mdx --- snippets/amd-install.mdx | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/snippets/amd-install.mdx b/snippets/amd-install.mdx index 1d2dcbe1..e1e5dd22 100644 --- a/snippets/amd-install.mdx +++ b/snippets/amd-install.mdx @@ -1,12 +1,17 @@ -``` -pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0 +AMD users can install rocm and pytorch with pip if you don't have it already installed, this is the command to install the stable version: + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 ``` Alternatively, you can install the nightly version of PyTorch. Install Nightly version (might be more risky) -``` -pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.0 + +This is the command to install the nightly with ROCm 7.0 which might have some performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 ``` From 0fe2e31dd6a376ba5742759757f6c48f9e45b892 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:35:52 +0000 Subject: [PATCH 03/82] Update snippets/amd-experimental-install.mdx --- snippets/amd-experimental-install.mdx | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 snippets/amd-experimental-install.mdx diff --git a/snippets/amd-experimental-install.mdx b/snippets/amd-experimental-install.mdx new file mode 100644 index 00000000..89601934 --- /dev/null +++ b/snippets/amd-experimental-install.mdx @@ -0,0 +1,23 @@ + +Experimental support for Windows and Linux. RDNA 3, 3.5 and 4 only. + +These have less hardware support than the builds above but they work on Windows. You also need to install the pytorch version specific to your hardware. + + +**RDNA 3 (RX 7000 series):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ +``` + +**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ +``` + +**RDNA 4 (RX 9000 series):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ +``` From d088f9bc9b22605fa87b1b30798d60b8b7368d0f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:36:00 +0000 Subject: [PATCH 04/82] Update snippets/install-gpu-dependencies.mdx --- snippets/install-gpu-dependencies.mdx | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/snippets/install-gpu-dependencies.mdx b/snippets/install-gpu-dependencies.mdx index 2e63c43d..6e98ef76 100644 --- a/snippets/install-gpu-dependencies.mdx +++ b/snippets/install-gpu-dependencies.mdx @@ -1,5 +1,7 @@ import AmdInstall from "/snippets/amd-install.mdx"; +import AmdExperimentalInstall from "/snippets/amd-experimental-install.mdx"; import NvidiaInstall from "/snippets/nvidia-install.mdx"; +import IntelInstall from "/snippets/intel-install.mdx"; import MacInstall from "/snippets/mac-silicon-install.mdx"; Install GPU Dependencies @@ -7,9 +9,15 @@ Install GPU Dependencies - + + + + + + + From ba45e9961d69e8b095780f9a460d8a5f8ba5413e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:36:13 +0000 Subject: [PATCH 05/82] Update snippets/intel-install.mdx --- snippets/intel-install.mdx | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 snippets/intel-install.mdx diff --git a/snippets/intel-install.mdx b/snippets/intel-install.mdx new file mode 100644 index 00000000..94af5fc5 --- /dev/null +++ b/snippets/intel-install.mdx @@ -0,0 +1,25 @@ +Intel Arc GPU users can install native PyTorch with torch.xpu support using pip. More information can be found [here](https://pytorch.org/docs/main/notes/get_start_xpu.html). + +**Option 1: Install PyTorch xpu** + +To install PyTorch xpu, use the following command: + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu +``` + + +Install Nightly version (might be more risky) + +This is the command to install the Pytorch xpu nightly which might have some performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu +``` + + +**Option 2: Intel Extension for PyTorch (IPEX)** + +Alternatively, Intel GPUs supported by Intel Extension for PyTorch (IPEX) can leverage IPEX for improved performance. + +Visit [Installation](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu) for more information. From 88104b4a114776b93f0fc3f17f6ab51f8b2a2fa8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:36:27 +0000 Subject: [PATCH 06/82] Update snippets/nvidia-install.mdx --- snippets/nvidia-install.mdx | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/snippets/nvidia-install.mdx b/snippets/nvidia-install.mdx index 649ec826..52f199f5 100644 --- a/snippets/nvidia-install.mdx +++ b/snippets/nvidia-install.mdx @@ -1,12 +1,27 @@ -``` -conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia +Nvidia users should install stable pytorch using this command: + +```bash +pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 ``` Alternatively, you can install the nightly version of PyTorch. Install Nightly version (might be more risky) + +This is the command to install pytorch nightly instead which might have performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 ``` -conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch-nightly -c nvidia + + + +If you get the "Torch not compiled with CUDA enabled" error, uninstall torch with: + +```bash +pip uninstall torch ``` + +And install it again with the command above. \ No newline at end of file From 49058a55bb33b6b392442ffd651f4daa88414fe8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:36:41 +0000 Subject: [PATCH 07/82] Update snippets/mac-silicon-install.mdx --- snippets/mac-silicon-install.mdx | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/snippets/mac-silicon-install.mdx b/snippets/mac-silicon-install.mdx index 7b247626..71b5e2c0 100644 --- a/snippets/mac-silicon-install.mdx +++ b/snippets/mac-silicon-install.mdx @@ -1,3 +1,11 @@ -``` bash +You can install ComfyUI in Apple Mac silicon (M1 or M2) with any recent macOS version. + +Install pytorch nightly. For instructions, read the [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer guide (make sure to install the latest pytorch nightly). + +```bash conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly -``` \ No newline at end of file +``` + + +Remember to add your models, VAE, LoRAs etc. to the corresponding Comfy folders (models/checkpoints, models/vae, etc.). + \ No newline at end of file From 44f1d701e2242a2614327ccaf48389f05072de0c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:36:57 +0000 Subject: [PATCH 08/82] Update snippets/ascend-install.mdx --- snippets/ascend-install.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 snippets/ascend-install.mdx diff --git a/snippets/ascend-install.mdx b/snippets/ascend-install.mdx new file mode 100644 index 00000000..6a686977 --- /dev/null +++ b/snippets/ascend-install.mdx @@ -0,0 +1,8 @@ +For models compatible with Ascend Extension for PyTorch (torch_npu). To get started, ensure your environment meets the prerequisites outlined on the [installation](https://ascend.github.io/docs/sources/ascend/quick_install.html) page. + +**Step-by-step guide:** + +1. Begin by installing the recommended or newer kernel version for Linux as specified in the Installation page of torch-npu, if necessary. +2. Proceed with the installation of Ascend Basekit, which includes the driver, firmware, and CANN, following the instructions provided for your specific platform. +3. Next, install the necessary packages for torch-npu by adhering to the platform-specific instructions on the [Installation](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch) page. +4. Finally, follow the ComfyUI manual installation guide for Linux. Once all components are installed, you can run ComfyUI as described earlier. From 392a1d9fd641d04971a4da16663446a9f3a5d43c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:37:01 +0000 Subject: [PATCH 09/82] Update snippets/cambricon-install.mdx --- snippets/cambricon-install.mdx | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 snippets/cambricon-install.mdx diff --git a/snippets/cambricon-install.mdx b/snippets/cambricon-install.mdx new file mode 100644 index 00000000..4b436c3f --- /dev/null +++ b/snippets/cambricon-install.mdx @@ -0,0 +1,7 @@ +For models compatible with Cambricon Extension for PyTorch (torch_mlu). + +**Step-by-step guide:** + +1. Install the Cambricon CNToolkit by adhering to the platform-specific instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html) +2. Next, install the PyTorch(torch_mlu) following the instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html) +3. Launch ComfyUI by running `python main.py` From e91d10eadfc47b3ca113461ad1d4ca360370b231 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:37:08 +0000 Subject: [PATCH 10/82] Update snippets/iluvatar-install.mdx --- snippets/iluvatar-install.mdx | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 snippets/iluvatar-install.mdx diff --git a/snippets/iluvatar-install.mdx b/snippets/iluvatar-install.mdx new file mode 100644 index 00000000..cc789831 --- /dev/null +++ b/snippets/iluvatar-install.mdx @@ -0,0 +1,6 @@ +For models compatible with Iluvatar Extension for PyTorch. + +**Step-by-step guide:** + +1. Install the Iluvatar Corex Toolkit by adhering to the platform-specific instructions on the [Installation](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536) +2. Launch ComfyUI by running `python main.py` From 64f59850d9e8f8e69bae4b2afaffa2b32c9bb4ec Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:37:19 +0000 Subject: [PATCH 11/82] Update snippets/install-gpu-dependencies.mdx --- snippets/install-gpu-dependencies.mdx | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/snippets/install-gpu-dependencies.mdx b/snippets/install-gpu-dependencies.mdx index 6e98ef76..1c722629 100644 --- a/snippets/install-gpu-dependencies.mdx +++ b/snippets/install-gpu-dependencies.mdx @@ -3,6 +3,9 @@ import AmdExperimentalInstall from "/snippets/amd-experimental-install.mdx"; import NvidiaInstall from "/snippets/nvidia-install.mdx"; import IntelInstall from "/snippets/intel-install.mdx"; import MacInstall from "/snippets/mac-silicon-install.mdx"; +import AscendInstall from "/snippets/ascend-install.mdx"; +import CambriconInstall from "/snippets/cambricon-install.mdx"; +import IluvatarInstall from "/snippets/iluvatar-install.mdx"; Install GPU Dependencies @@ -21,3 +24,12 @@ Install GPU Dependencies + + + + + + + + + From 40143cf0eaad6abc21c4211e4eacc384af72b529 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:40:00 +0000 Subject: [PATCH 12/82] Update zh-CN/installation/manual_install.mdx --- zh-CN/installation/manual_install.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/zh-CN/installation/manual_install.mdx b/zh-CN/installation/manual_install.mdx index dc007c88..ba968afe 100644 --- a/zh-CN/installation/manual_install.mdx +++ b/zh-CN/installation/manual_install.mdx @@ -18,6 +18,12 @@ import AddExternalModels from "/snippets/zh/install/add-external-models.mdx" 3. 安装依赖 4. 启动 ComfyUI + +Python 3.13 支持非常好。如果你在 3.13 上遇到某些自定义节点依赖问题，可以尝试使用 3.12。 + +Python 3.14 可以工作，但需要在 requirements.txt 文件中注释掉 `kornia` 依赖（会导致 canny 节点失效），不建议使用。 + + 你也可以参考 [ComfyUI CLI](/zh-CN/comfy-cli/getting-started) 来安装 ComfyUI, 它是一个命令行工具，可以方便地安装 ComfyUI 并管理其依赖。 ## （可选）创建虚拟环境 From f053303626cbc8e9d1917d59097c1e4be21119e7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:43:23 +0000 Subject: [PATCH 13/82] Update snippets/zh/amd-experimental-install.mdx --- snippets/zh/amd-experimental-install.mdx | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 snippets/zh/amd-experimental-install.mdx diff --git a/snippets/zh/amd-experimental-install.mdx b/snippets/zh/amd-experimental-install.mdx new file mode 100644 index 00000000..43904ed1 --- /dev/null +++ b/snippets/zh/amd-experimental-install.mdx @@ -0,0 +1,23 @@ + +Windows 和 Linux 的实验性支持。仅支持 RDNA 3、3.5 和 4。 + +这些版本的硬件支持比上述版本少，但它们可以在 Windows 上运行。您还需要安装特定于您硬件的 PyTorch 版本。 + + +**RDNA 3 (RX 7000 系列):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ +``` + +**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ +``` + +**RDNA 4 (RX 9000 系列):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ +``` From 4eee8d0f83c519f44cd8daab93520145f0f6ceb7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:43:38 +0000 Subject: [PATCH 14/82] Update snippets/zh/intel-install.mdx --- snippets/zh/intel-install.mdx | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 snippets/zh/intel-install.mdx diff --git a/snippets/zh/intel-install.mdx b/snippets/zh/intel-install.mdx new file mode 100644 index 00000000..809bfc9c --- /dev/null +++ b/snippets/zh/intel-install.mdx @@ -0,0 +1,25 @@ +Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在[这里](https://pytorch.org/docs/main/notes/get_start_xpu.html)找到。 + +**选项 1: 安装 PyTorch xpu** + +要安装 PyTorch xpu，请使用以下命令： + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu +``` + + +安装夜间版本（可能风险更大） + +这是安装 PyTorch xpu 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu +``` + + +**选项 2: Intel Extension for PyTorch (IPEX)** + +或者，Intel Extension for PyTorch (IPEX) 支持的 Intel GPU 可以利用 IPEX 来提高性能。 + +访问[安装页面](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu)了解更多信息。 From 17fe23083fd0fc562e77eb229b5f7a3c00fe0848 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:43:53 +0000 Subject: [PATCH 15/82] Update snippets/zh/ascend-install.mdx --- snippets/zh/ascend-install.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 snippets/zh/ascend-install.mdx diff --git a/snippets/zh/ascend-install.mdx b/snippets/zh/ascend-install.mdx new file mode 100644 index 00000000..494329d4 --- /dev/null +++ b/snippets/zh/ascend-install.mdx @@ -0,0 +1,8 @@ +适用于与 Ascend Extension for PyTorch (torch_npu) 兼容的模型。要开始使用，请确保您的环境满足[安装页面](https://ascend.github.io/docs/sources/ascend/quick_install.html)上列出的先决条件。 + +**分步指南：** + +1. 首先，如有必要，按照 torch-npu 安装页面中指定的要求，为 Linux 安装推荐或更新的内核版本。 +2. 继续安装 Ascend Basekit，其中包括驱动程序、固件和 CANN，按照您特定平台的说明进行操作。 +3. 接下来，按照[安装页面](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch)上的平台特定说明安装 torch-npu 所需的软件包。 +4. 最后，按照 Linux 的 ComfyUI 手动安装指南进行操作。安装所有组件后，您可以按照前面所述运行 ComfyUI。 From fd3b38a0db02d4a0dfeefce2f830d79d99e90848 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:44:05 +0000 Subject: [PATCH 16/82] Update snippets/zh/cambricon-install.mdx --- snippets/zh/cambricon-install.mdx | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 snippets/zh/cambricon-install.mdx diff --git a/snippets/zh/cambricon-install.mdx b/snippets/zh/cambricon-install.mdx new file mode 100644 index 00000000..7e7cb9f9 --- /dev/null +++ b/snippets/zh/cambricon-install.mdx @@ -0,0 +1,7 @@ +适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。 + +**分步指南：** + +1. 按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html)上的平台特定说明安装 Cambricon CNToolkit +2. 接下来，按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html)上的说明安装 PyTorch(torch_mlu) +3. 通过运行 `python main.py` 启动 ComfyUI From 3df9e76f8eb874ed5f3a4d325cf14a1fee2aa80d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:44:17 +0000 Subject: [PATCH 17/82] Update snippets/zh/iluvatar-install.mdx --- snippets/zh/iluvatar-install.mdx | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 snippets/zh/iluvatar-install.mdx diff --git a/snippets/zh/iluvatar-install.mdx b/snippets/zh/iluvatar-install.mdx new file mode 100644 index 00000000..ace7b154 --- /dev/null +++ b/snippets/zh/iluvatar-install.mdx @@ -0,0 +1,6 @@ +适用于与 Iluvatar Extension for PyTorch 兼容的模型。 + +**分步指南：** + +1. 按照[安装页面](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536)上的平台特定说明安装 Iluvatar Corex Toolkit +2. 通过运行 `python main.py` 启动 ComfyUI From 2a41287dd3c99270265d699a86ee090cff56a742 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:44:33 +0000 Subject: [PATCH 18/82] Update snippets/zh/install-gpu-dependencies.mdx --- snippets/zh/install-gpu-dependencies.mdx | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/snippets/zh/install-gpu-dependencies.mdx b/snippets/zh/install-gpu-dependencies.mdx index 8e4277e4..aaf82bd2 100644 --- a/snippets/zh/install-gpu-dependencies.mdx +++ b/snippets/zh/install-gpu-dependencies.mdx @@ -1,15 +1,35 @@ import AmdInstall from "/snippets/zh/amd-install.mdx"; +import AmdExperimentalInstall from "/snippets/zh/amd-experimental-install.mdx"; import NvidiaInstall from "/snippets/zh/nvidia-install.mdx"; +import IntelInstall from "/snippets/zh/intel-install.mdx"; import MacInstall from "/snippets/mac-silicon-install.mdx"; +import AscendInstall from "/snippets/zh/ascend-install.mdx"; +import CambriconInstall from "/snippets/zh/cambricon-install.mdx"; +import IluvatarInstall from "/snippets/zh/iluvatar-install.mdx"; 安装 GPU 依赖 - + + + + + + + + + + + + + + + + From 7b3c6e19392219f2b4f4d430b6b401ac2e034b5d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:16 +0000 Subject: [PATCH 19/82] Update snippets/install/amd-install.mdx --- snippets/install/amd-install.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 snippets/install/amd-install.mdx diff --git a/snippets/install/amd-install.mdx b/snippets/install/amd-install.mdx new file mode 100644 index 00000000..e1e5dd22 --- /dev/null +++ b/snippets/install/amd-install.mdx @@ -0,0 +1,17 @@ +AMD users can install rocm and pytorch with pip if you don't have it already installed, this is the command to install the stable version: + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 +``` + +Alternatively, you can install the nightly version of PyTorch. + + +Install Nightly version (might be more risky) + +This is the command to install the nightly with ROCm 7.0 which might have some performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 +``` + From cd2a9c9a71def2c8513fad8d46420001515a068d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:20 +0000 Subject: [PATCH 20/82] Update snippets/install/amd-experimental-install.mdx --- snippets/install/amd-experimental-install.mdx | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 snippets/install/amd-experimental-install.mdx diff --git a/snippets/install/amd-experimental-install.mdx b/snippets/install/amd-experimental-install.mdx new file mode 100644 index 00000000..89601934 --- /dev/null +++ b/snippets/install/amd-experimental-install.mdx @@ -0,0 +1,23 @@ + +Experimental support for Windows and Linux. RDNA 3, 3.5 and 4 only. + +These have less hardware support than the builds above but they work on Windows. You also need to install the pytorch version specific to your hardware. + + +**RDNA 3 (RX 7000 series):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ +``` + +**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ +``` + +**RDNA 4 (RX 9000 series):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ +``` From 74559edae061610768afff63edf7edbb049962d1 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:23 +0000 Subject: [PATCH 21/82] Update snippets/install/nvidia-install.mdx --- snippets/install/nvidia-install.mdx | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 snippets/install/nvidia-install.mdx diff --git a/snippets/install/nvidia-install.mdx b/snippets/install/nvidia-install.mdx new file mode 100644 index 00000000..52f199f5 --- /dev/null +++ b/snippets/install/nvidia-install.mdx @@ -0,0 +1,27 @@ +Nvidia users should install stable pytorch using this command: + +```bash +pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 +``` + +Alternatively, you can install the nightly version of PyTorch. + + +Install Nightly version (might be more risky) + +This is the command to install pytorch nightly instead which might have performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 +``` + + + +If you get the "Torch not compiled with CUDA enabled" error, uninstall torch with: + +```bash +pip uninstall torch +``` + +And install it again with the command above. + \ No newline at end of file From e61adb97f4cf8c1a394001a66d988b17cc40d37a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:26 +0000 Subject: [PATCH 22/82] Update snippets/install/intel-install.mdx --- snippets/install/intel-install.mdx | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 snippets/install/intel-install.mdx diff --git a/snippets/install/intel-install.mdx b/snippets/install/intel-install.mdx new file mode 100644 index 00000000..94af5fc5 --- /dev/null +++ b/snippets/install/intel-install.mdx @@ -0,0 +1,25 @@ +Intel Arc GPU users can install native PyTorch with torch.xpu support using pip. More information can be found [here](https://pytorch.org/docs/main/notes/get_start_xpu.html). + +**Option 1: Install PyTorch xpu** + +To install PyTorch xpu, use the following command: + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu +``` + + +Install Nightly version (might be more risky) + +This is the command to install the Pytorch xpu nightly which might have some performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu +``` + + +**Option 2: Intel Extension for PyTorch (IPEX)** + +Alternatively, Intel GPUs supported by Intel Extension for PyTorch (IPEX) can leverage IPEX for improved performance. + +Visit [Installation](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu) for more information. From 5461978b9d9b9011a24c3fa0b00ac30cd401c541 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:31 +0000 Subject: [PATCH 23/82] Update snippets/install/mac-silicon-install.mdx --- snippets/install/mac-silicon-install.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 snippets/install/mac-silicon-install.mdx diff --git a/snippets/install/mac-silicon-install.mdx b/snippets/install/mac-silicon-install.mdx new file mode 100644 index 00000000..71b5e2c0 --- /dev/null +++ b/snippets/install/mac-silicon-install.mdx @@ -0,0 +1,11 @@ +You can install ComfyUI in Apple Mac silicon (M1 or M2) with any recent macOS version. + +Install pytorch nightly. For instructions, read the [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer guide (make sure to install the latest pytorch nightly). + +```bash +conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly +``` + + +Remember to add your models, VAE, LoRAs etc. to the corresponding Comfy folders (models/checkpoints, models/vae, etc.). + \ No newline at end of file From 117967da605dfbc42a792090f00109a34c40dca3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:35 +0000 Subject: [PATCH 24/82] Update snippets/install/ascend-install.mdx --- snippets/install/ascend-install.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 snippets/install/ascend-install.mdx diff --git a/snippets/install/ascend-install.mdx b/snippets/install/ascend-install.mdx new file mode 100644 index 00000000..6a686977 --- /dev/null +++ b/snippets/install/ascend-install.mdx @@ -0,0 +1,8 @@ +For models compatible with Ascend Extension for PyTorch (torch_npu). To get started, ensure your environment meets the prerequisites outlined on the [installation](https://ascend.github.io/docs/sources/ascend/quick_install.html) page. + +**Step-by-step guide:** + +1. Begin by installing the recommended or newer kernel version for Linux as specified in the Installation page of torch-npu, if necessary. +2. Proceed with the installation of Ascend Basekit, which includes the driver, firmware, and CANN, following the instructions provided for your specific platform. +3. Next, install the necessary packages for torch-npu by adhering to the platform-specific instructions on the [Installation](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch) page. +4. Finally, follow the ComfyUI manual installation guide for Linux. Once all components are installed, you can run ComfyUI as described earlier. From 293281618e430d5d3601a767408cf567aab82a6c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:37 +0000 Subject: [PATCH 25/82] Update snippets/install/cambricon-install.mdx --- snippets/install/cambricon-install.mdx | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 snippets/install/cambricon-install.mdx diff --git a/snippets/install/cambricon-install.mdx b/snippets/install/cambricon-install.mdx new file mode 100644 index 00000000..4b436c3f --- /dev/null +++ b/snippets/install/cambricon-install.mdx @@ -0,0 +1,7 @@ +For models compatible with Cambricon Extension for PyTorch (torch_mlu). + +**Step-by-step guide:** + +1. Install the Cambricon CNToolkit by adhering to the platform-specific instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html) +2. Next, install the PyTorch(torch_mlu) following the instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html) +3. Launch ComfyUI by running `python main.py` From d0c65e26d6f3bc451f35bbdbe2c7181cdca692e7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:38 +0000 Subject: [PATCH 26/82] Update snippets/install/iluvatar-install.mdx --- snippets/install/iluvatar-install.mdx | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 snippets/install/iluvatar-install.mdx diff --git a/snippets/install/iluvatar-install.mdx b/snippets/install/iluvatar-install.mdx new file mode 100644 index 00000000..cc789831 --- /dev/null +++ b/snippets/install/iluvatar-install.mdx @@ -0,0 +1,6 @@ +For models compatible with Iluvatar Extension for PyTorch. + +**Step-by-step guide:** + +1. Install the Iluvatar Corex Toolkit by adhering to the platform-specific instructions on the [Installation](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536) +2. Launch ComfyUI by running `python main.py` From 79fa5991ad1d40c19967c1af4a5e7438fbb29cff Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:54 +0000 Subject: [PATCH 27/82] Update snippets/zh/install/amd-install.mdx --- snippets/zh/install/amd-install.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 snippets/zh/install/amd-install.mdx diff --git a/snippets/zh/install/amd-install.mdx b/snippets/zh/install/amd-install.mdx new file mode 100644 index 00000000..66fdb115 --- /dev/null +++ b/snippets/zh/install/amd-install.mdx @@ -0,0 +1,17 @@ +AMD 用户可以使用 pip 安装 rocm 和 pytorch（如果尚未安装），这是安装稳定版本的命令： + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 +``` + +或者，您可以安装 PyTorch 的夜间版本。 + + +安装夜间版本（可能风险更大） + +这是安装 ROCm 7.0 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 +``` + From 2d627be3d0e11b042115b3040262d74b53ec0221 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:49:57 +0000 Subject: [PATCH 28/82] Update snippets/zh/install/amd-experimental-install.mdx --- .../zh/install/amd-experimental-install.mdx | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 snippets/zh/install/amd-experimental-install.mdx diff --git a/snippets/zh/install/amd-experimental-install.mdx b/snippets/zh/install/amd-experimental-install.mdx new file mode 100644 index 00000000..43904ed1 --- /dev/null +++ b/snippets/zh/install/amd-experimental-install.mdx @@ -0,0 +1,23 @@ + +Windows 和 Linux 的实验性支持。仅支持 RDNA 3、3.5 和 4。 + +这些版本的硬件支持比上述版本少，但它们可以在 Windows 上运行。您还需要安装特定于您硬件的 PyTorch 版本。 + + +**RDNA 3 (RX 7000 系列):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ +``` + +**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ +``` + +**RDNA 4 (RX 9000 系列):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ +``` From 58518e6b5123cd316d92243722ee672d9d71f9e8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:00 +0000 Subject: [PATCH 29/82] Update snippets/zh/install/nvidia-install.mdx --- snippets/zh/install/nvidia-install.mdx | 27 ++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 snippets/zh/install/nvidia-install.mdx diff --git a/snippets/zh/install/nvidia-install.mdx b/snippets/zh/install/nvidia-install.mdx new file mode 100644 index 00000000..33f1d5d0 --- /dev/null +++ b/snippets/zh/install/nvidia-install.mdx @@ -0,0 +1,27 @@ +Nvidia 用户应使用以下命令安装稳定版 pytorch： + +```bash +pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 +``` + +或者，您可以安装 PyTorch 的夜间版本。 + + +安装夜间版本（可能风险更大） + +这是安装 pytorch 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 +``` + + + +如果您遇到 "Torch not compiled with CUDA enabled" 错误，请使用以下命令卸载 torch： + +```bash +pip uninstall torch +``` + +然后使用上述命令重新安装。 + \ No newline at end of file From 2029e0b99ff8637dd38faef137aee3ccd736667f Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:06 +0000 Subject: [PATCH 30/82] Update snippets/zh/install/mac-silicon-install.mdx --- snippets/zh/install/mac-silicon-install.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 snippets/zh/install/mac-silicon-install.mdx diff --git a/snippets/zh/install/mac-silicon-install.mdx b/snippets/zh/install/mac-silicon-install.mdx new file mode 100644 index 00000000..a37826a8 --- /dev/null +++ b/snippets/zh/install/mac-silicon-install.mdx @@ -0,0 +1,11 @@ +您可以在任何最新的 macOS 版本上的 Apple Mac silicon（M1 或 M2）中安装 ComfyUI。 + +安装 pytorch nightly。有关说明，请阅读 [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer 指南（确保安装最新的 pytorch nightly）。 + +```bash +conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly +``` + + +记得将您的模型、VAE、LoRA 等添加到相应的 Comfy 文件夹（models/checkpoints、models/vae 等）。 + \ No newline at end of file From 8e147283857d45aa7c9723eec0ea0e8075630083 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:10 +0000 Subject: [PATCH 31/82] Update snippets/zh/install/ascend-install.mdx --- snippets/zh/install/ascend-install.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 snippets/zh/install/ascend-install.mdx diff --git a/snippets/zh/install/ascend-install.mdx b/snippets/zh/install/ascend-install.mdx new file mode 100644 index 00000000..494329d4 --- /dev/null +++ b/snippets/zh/install/ascend-install.mdx @@ -0,0 +1,8 @@ +适用于与 Ascend Extension for PyTorch (torch_npu) 兼容的模型。要开始使用，请确保您的环境满足[安装页面](https://ascend.github.io/docs/sources/ascend/quick_install.html)上列出的先决条件。 + +**分步指南：** + +1. 首先，如有必要，按照 torch-npu 安装页面中指定的要求，为 Linux 安装推荐或更新的内核版本。 +2. 继续安装 Ascend Basekit，其中包括驱动程序、固件和 CANN，按照您特定平台的说明进行操作。 +3. 接下来，按照[安装页面](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch)上的平台特定说明安装 torch-npu 所需的软件包。 +4. 最后，按照 Linux 的 ComfyUI 手动安装指南进行操作。安装所有组件后，您可以按照前面所述运行 ComfyUI。 From b4b3b284bd4ff461333619206de5ea5b2071cf3d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:14 +0000 Subject: [PATCH 32/82] Update snippets/zh/install/iluvatar-install.mdx --- snippets/zh/install/iluvatar-install.mdx | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 snippets/zh/install/iluvatar-install.mdx diff --git a/snippets/zh/install/iluvatar-install.mdx b/snippets/zh/install/iluvatar-install.mdx new file mode 100644 index 00000000..ace7b154 --- /dev/null +++ b/snippets/zh/install/iluvatar-install.mdx @@ -0,0 +1,6 @@ +适用于与 Iluvatar Extension for PyTorch 兼容的模型。 + +**分步指南：** + +1. 按照[安装页面](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536)上的平台特定说明安装 Iluvatar Corex Toolkit +2. 通过运行 `python main.py` 启动 ComfyUI From 6325c85a9b54ed0f0e26bfd2c93391a29cfaf565 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:22 +0000 Subject: [PATCH 33/82] Update snippets/zh/install/intel-install.mdx --- snippets/zh/install/intel-install.mdx | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 snippets/zh/install/intel-install.mdx diff --git a/snippets/zh/install/intel-install.mdx b/snippets/zh/install/intel-install.mdx new file mode 100644 index 00000000..809bfc9c --- /dev/null +++ b/snippets/zh/install/intel-install.mdx @@ -0,0 +1,25 @@ +Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在[这里](https://pytorch.org/docs/main/notes/get_start_xpu.html)找到。 + +**选项 1: 安装 PyTorch xpu** + +要安装 PyTorch xpu，请使用以下命令： + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu +``` + + +安装夜间版本（可能风险更大） + +这是安装 PyTorch xpu 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu +``` + + +**选项 2: Intel Extension for PyTorch (IPEX)** + +或者，Intel Extension for PyTorch (IPEX) 支持的 Intel GPU 可以利用 IPEX 来提高性能。 + +访问[安装页面](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu)了解更多信息。 From 96a724eae9797668187b4e41a4f3477a1e3c1bc7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:32 +0000 Subject: [PATCH 34/82] Update snippets/zh/install/cambricon-install.mdx --- snippets/zh/install/cambricon-install.mdx | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 snippets/zh/install/cambricon-install.mdx diff --git a/snippets/zh/install/cambricon-install.mdx b/snippets/zh/install/cambricon-install.mdx new file mode 100644 index 00000000..7e7cb9f9 --- /dev/null +++ b/snippets/zh/install/cambricon-install.mdx @@ -0,0 +1,7 @@ +适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。 + +**分步指南：** + +1. 按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html)上的平台特定说明安装 Cambricon CNToolkit +2. 接下来，按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html)上的说明安装 PyTorch(torch_mlu) +3. 通过运行 `python main.py` 启动 ComfyUI From 3e6168922b05f1cd251e435d78ed6519138ef6b3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:51 +0000 Subject: [PATCH 35/82] Update snippets/install-gpu-dependencies.mdx --- snippets/install-gpu-dependencies.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/snippets/install-gpu-dependencies.mdx b/snippets/install-gpu-dependencies.mdx index 1c722629..13885049 100644 --- a/snippets/install-gpu-dependencies.mdx +++ b/snippets/install-gpu-dependencies.mdx @@ -1,11 +1,11 @@ -import AmdInstall from "/snippets/amd-install.mdx"; -import AmdExperimentalInstall from "/snippets/amd-experimental-install.mdx"; -import NvidiaInstall from "/snippets/nvidia-install.mdx"; -import IntelInstall from "/snippets/intel-install.mdx"; -import MacInstall from "/snippets/mac-silicon-install.mdx"; -import AscendInstall from "/snippets/ascend-install.mdx"; -import CambriconInstall from "/snippets/cambricon-install.mdx"; -import IluvatarInstall from "/snippets/iluvatar-install.mdx"; +import AmdInstall from "/snippets/install/amd-install.mdx"; +import AmdExperimentalInstall from "/snippets/install/amd-experimental-install.mdx"; +import NvidiaInstall from "/snippets/install/nvidia-install.mdx"; +import IntelInstall from "/snippets/install/intel-install.mdx"; +import MacInstall from "/snippets/install/mac-silicon-install.mdx"; +import AscendInstall from "/snippets/install/ascend-install.mdx"; +import CambriconInstall from "/snippets/install/cambricon-install.mdx"; +import IluvatarInstall from "/snippets/install/iluvatar-install.mdx"; Install GPU Dependencies From 6d02e2c8dc45b8ead83e51c7df7460ac30624eb9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:50:55 +0000 Subject: [PATCH 36/82] Update snippets/zh/install-gpu-dependencies.mdx --- snippets/zh/install-gpu-dependencies.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/snippets/zh/install-gpu-dependencies.mdx b/snippets/zh/install-gpu-dependencies.mdx index aaf82bd2..cb2ea180 100644 --- a/snippets/zh/install-gpu-dependencies.mdx +++ b/snippets/zh/install-gpu-dependencies.mdx @@ -1,11 +1,11 @@ -import AmdInstall from "/snippets/zh/amd-install.mdx"; -import AmdExperimentalInstall from "/snippets/zh/amd-experimental-install.mdx"; -import NvidiaInstall from "/snippets/zh/nvidia-install.mdx"; -import IntelInstall from "/snippets/zh/intel-install.mdx"; -import MacInstall from "/snippets/mac-silicon-install.mdx"; -import AscendInstall from "/snippets/zh/ascend-install.mdx"; -import CambriconInstall from "/snippets/zh/cambricon-install.mdx"; -import IluvatarInstall from "/snippets/zh/iluvatar-install.mdx"; +import AmdInstall from "/snippets/zh/install/amd-install.mdx"; +import AmdExperimentalInstall from "/snippets/zh/install/amd-experimental-install.mdx"; +import NvidiaInstall from "/snippets/zh/install/nvidia-install.mdx"; +import IntelInstall from "/snippets/zh/install/intel-install.mdx"; +import MacInstall from "/snippets/zh/install/mac-silicon-install.mdx"; +import AscendInstall from "/snippets/zh/install/ascend-install.mdx"; +import CambriconInstall from "/snippets/zh/install/cambricon-install.mdx"; +import IluvatarInstall from "/snippets/zh/install/iluvatar-install.mdx"; 安装 GPU 依赖 From fa4b4a9b3bbc801647d965c73aa8e9b569001d81 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:12 +0000 Subject: [PATCH 37/82] Update snippets/zh/install/mac-silicon-install.mdx From 035ba3a21fe3c3f6e15fce9ba946a0b1f376a17a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:24 +0000 Subject: [PATCH 38/82] Delete snippets/amd-install.mdx --- snippets/amd-install.mdx | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 snippets/amd-install.mdx diff --git a/snippets/amd-install.mdx b/snippets/amd-install.mdx deleted file mode 100644 index e1e5dd22..00000000 --- a/snippets/amd-install.mdx +++ /dev/null @@ -1,17 +0,0 @@ -AMD users can install rocm and pytorch with pip if you don't have it already installed, this is the command to install the stable version: - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 -``` - -Alternatively, you can install the nightly version of PyTorch. - - -Install Nightly version (might be more risky) - -This is the command to install the nightly with ROCm 7.0 which might have some performance improvements: - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 -``` - From 67a2cbe7d5942c6a11339e86b1aab60fa6aa1688 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:25 +0000 Subject: [PATCH 39/82] Delete snippets/nvidia-install.mdx --- snippets/nvidia-install.mdx | 27 --------------------------- 1 file changed, 27 deletions(-) delete mode 100644 snippets/nvidia-install.mdx diff --git a/snippets/nvidia-install.mdx b/snippets/nvidia-install.mdx deleted file mode 100644 index 52f199f5..00000000 --- a/snippets/nvidia-install.mdx +++ /dev/null @@ -1,27 +0,0 @@ -Nvidia users should install stable pytorch using this command: - -```bash -pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 -``` - -Alternatively, you can install the nightly version of PyTorch. - - -Install Nightly version (might be more risky) - -This is the command to install pytorch nightly instead which might have performance improvements: - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 -``` - - - -If you get the "Torch not compiled with CUDA enabled" error, uninstall torch with: - -```bash -pip uninstall torch -``` - -And install it again with the command above. - \ No newline at end of file From d22369978024c3b4b4c6682cb00880a94f7bd368 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:26 +0000 Subject: [PATCH 40/82] Delete snippets/intel-install.mdx --- snippets/intel-install.mdx | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 snippets/intel-install.mdx diff --git a/snippets/intel-install.mdx b/snippets/intel-install.mdx deleted file mode 100644 index 94af5fc5..00000000 --- a/snippets/intel-install.mdx +++ /dev/null @@ -1,25 +0,0 @@ -Intel Arc GPU users can install native PyTorch with torch.xpu support using pip. More information can be found [here](https://pytorch.org/docs/main/notes/get_start_xpu.html). - -**Option 1: Install PyTorch xpu** - -To install PyTorch xpu, use the following command: - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu -``` - - -Install Nightly version (might be more risky) - -This is the command to install the Pytorch xpu nightly which might have some performance improvements: - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu -``` - - -**Option 2: Intel Extension for PyTorch (IPEX)** - -Alternatively, Intel GPUs supported by Intel Extension for PyTorch (IPEX) can leverage IPEX for improved performance. - -Visit [Installation](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu) for more information. From 2415872e7cb5db99b2137399b98f10d200663d3e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:31 +0000 Subject: [PATCH 41/82] Delete snippets/amd-experimental-install.mdx --- snippets/amd-experimental-install.mdx | 23 ----------------------- 1 file changed, 23 deletions(-) delete mode 100644 snippets/amd-experimental-install.mdx diff --git a/snippets/amd-experimental-install.mdx b/snippets/amd-experimental-install.mdx deleted file mode 100644 index 89601934..00000000 --- a/snippets/amd-experimental-install.mdx +++ /dev/null @@ -1,23 +0,0 @@ - -Experimental support for Windows and Linux. RDNA 3, 3.5 and 4 only. - -These have less hardware support than the builds above but they work on Windows. You also need to install the pytorch version specific to your hardware. - - -**RDNA 3 (RX 7000 series):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ -``` - -**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ -``` - -**RDNA 4 (RX 9000 series):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ -``` From da41f00e5ea87582939751682fa449b47d6ac58b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:32 +0000 Subject: [PATCH 42/82] Delete snippets/mac-silicon-install.mdx --- snippets/mac-silicon-install.mdx | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 snippets/mac-silicon-install.mdx diff --git a/snippets/mac-silicon-install.mdx b/snippets/mac-silicon-install.mdx deleted file mode 100644 index 71b5e2c0..00000000 --- a/snippets/mac-silicon-install.mdx +++ /dev/null @@ -1,11 +0,0 @@ -You can install ComfyUI in Apple Mac silicon (M1 or M2) with any recent macOS version. - -Install pytorch nightly. For instructions, read the [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer guide (make sure to install the latest pytorch nightly). - -```bash -conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly -``` - - -Remember to add your models, VAE, LoRAs etc. to the corresponding Comfy folders (models/checkpoints, models/vae, etc.). - \ No newline at end of file From d162d4d5feabd2f5b6ff550687e3f3bbece16e98 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:33 +0000 Subject: [PATCH 43/82] Delete snippets/ascend-install.mdx --- snippets/ascend-install.mdx | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 snippets/ascend-install.mdx diff --git a/snippets/ascend-install.mdx b/snippets/ascend-install.mdx deleted file mode 100644 index 6a686977..00000000 --- a/snippets/ascend-install.mdx +++ /dev/null @@ -1,8 +0,0 @@ -For models compatible with Ascend Extension for PyTorch (torch_npu). To get started, ensure your environment meets the prerequisites outlined on the [installation](https://ascend.github.io/docs/sources/ascend/quick_install.html) page. - -**Step-by-step guide:** - -1. Begin by installing the recommended or newer kernel version for Linux as specified in the Installation page of torch-npu, if necessary. -2. Proceed with the installation of Ascend Basekit, which includes the driver, firmware, and CANN, following the instructions provided for your specific platform. -3. Next, install the necessary packages for torch-npu by adhering to the platform-specific instructions on the [Installation](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch) page. -4. Finally, follow the ComfyUI manual installation guide for Linux. Once all components are installed, you can run ComfyUI as described earlier. From 6446ba3642a09a28c89b1ae1223c1d1eb8e13eba Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:39 +0000 Subject: [PATCH 44/82] Delete snippets/iluvatar-install.mdx --- snippets/iluvatar-install.mdx | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 snippets/iluvatar-install.mdx diff --git a/snippets/iluvatar-install.mdx b/snippets/iluvatar-install.mdx deleted file mode 100644 index cc789831..00000000 --- a/snippets/iluvatar-install.mdx +++ /dev/null @@ -1,6 +0,0 @@ -For models compatible with Iluvatar Extension for PyTorch. - -**Step-by-step guide:** - -1. Install the Iluvatar Corex Toolkit by adhering to the platform-specific instructions on the [Installation](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536) -2. Launch ComfyUI by running `python main.py` From 9b610e58cbfa558ef22fdb5b93313db3d65e2398 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:44 +0000 Subject: [PATCH 45/82] Delete snippets/cambricon-install.mdx --- snippets/cambricon-install.mdx | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 snippets/cambricon-install.mdx diff --git a/snippets/cambricon-install.mdx b/snippets/cambricon-install.mdx deleted file mode 100644 index 4b436c3f..00000000 --- a/snippets/cambricon-install.mdx +++ /dev/null @@ -1,7 +0,0 @@ -For models compatible with Cambricon Extension for PyTorch (torch_mlu). - -**Step-by-step guide:** - -1. Install the Cambricon CNToolkit by adhering to the platform-specific instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html) -2. Next, install the PyTorch(torch_mlu) following the instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html) -3. Launch ComfyUI by running `python main.py` From 323a6fa41b03f2ac05eaa6047b8c90f470d9dfc3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:49 +0000 Subject: [PATCH 46/82] Delete snippets/zh/amd-install.mdx --- snippets/zh/amd-install.mdx | 12 ------------ 1 file changed, 12 deletions(-) delete mode 100644 snippets/zh/amd-install.mdx diff --git a/snippets/zh/amd-install.mdx b/snippets/zh/amd-install.mdx deleted file mode 100644 index c8f5fa6e..00000000 --- a/snippets/zh/amd-install.mdx +++ /dev/null @@ -1,12 +0,0 @@ -``` -pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.0 -``` - -或者，您可以安装 PyTorch 的夜间版本。 - - -安装夜间版本（可能风险更大） -``` -pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.0 -``` - From 722b668966cf6b634207537eb9e93aab8445459a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:50 +0000 Subject: [PATCH 47/82] Delete snippets/zh/amd-experimental-install.mdx --- snippets/zh/amd-experimental-install.mdx | 23 ----------------------- 1 file changed, 23 deletions(-) delete mode 100644 snippets/zh/amd-experimental-install.mdx diff --git a/snippets/zh/amd-experimental-install.mdx b/snippets/zh/amd-experimental-install.mdx deleted file mode 100644 index 43904ed1..00000000 --- a/snippets/zh/amd-experimental-install.mdx +++ /dev/null @@ -1,23 +0,0 @@ - -Windows 和 Linux 的实验性支持。仅支持 RDNA 3、3.5 和 4。 - -这些版本的硬件支持比上述版本少，但它们可以在 Windows 上运行。您还需要安装特定于您硬件的 PyTorch 版本。 - - -**RDNA 3 (RX 7000 系列):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ -``` - -**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ -``` - -**RDNA 4 (RX 9000 系列):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ -``` From 876f9c77ef71d8c1c8d45e7cc6e2a91e23133bd8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:51 +0000 Subject: [PATCH 48/82] Delete snippets/zh/intel-install.mdx --- snippets/zh/intel-install.mdx | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 snippets/zh/intel-install.mdx diff --git a/snippets/zh/intel-install.mdx b/snippets/zh/intel-install.mdx deleted file mode 100644 index 809bfc9c..00000000 --- a/snippets/zh/intel-install.mdx +++ /dev/null @@ -1,25 +0,0 @@ -Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在[这里](https://pytorch.org/docs/main/notes/get_start_xpu.html)找到。 - -**选项 1: 安装 PyTorch xpu** - -要安装 PyTorch xpu，请使用以下命令： - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu -``` - - -安装夜间版本（可能风险更大） - -这是安装 PyTorch xpu 夜间版本的命令，可能会有一些性能改进： - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu -``` - - -**选项 2: Intel Extension for PyTorch (IPEX)** - -或者，Intel Extension for PyTorch (IPEX) 支持的 Intel GPU 可以利用 IPEX 来提高性能。 - -访问[安装页面](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu)了解更多信息。 From f19754dfa97126615cb0c3aa24e09174bcdcd676 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:57 +0000 Subject: [PATCH 49/82] Delete snippets/zh/nvidia-install.mdx --- snippets/zh/nvidia-install.mdx | 12 ------------ 1 file changed, 12 deletions(-) delete mode 100644 snippets/zh/nvidia-install.mdx diff --git a/snippets/zh/nvidia-install.mdx b/snippets/zh/nvidia-install.mdx deleted file mode 100644 index 13e33cb8..00000000 --- a/snippets/zh/nvidia-install.mdx +++ /dev/null @@ -1,12 +0,0 @@ -``` -conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch -c nvidia -``` - -或者，您可以安装 PyTorch 的夜间版本。 - - -安装夜间版本（可能风险更大） -``` -conda install pytorch torchvision torchaudio pytorch-cuda=12.1 -c pytorch-nightly -c nvidia -``` - \ No newline at end of file From 02cf19c5b3c2131d9b7b0649640cd0a77b4179aa Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:51:58 +0000 Subject: [PATCH 50/82] Delete snippets/zh/ascend-install.mdx --- snippets/zh/ascend-install.mdx | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 snippets/zh/ascend-install.mdx diff --git a/snippets/zh/ascend-install.mdx b/snippets/zh/ascend-install.mdx deleted file mode 100644 index 494329d4..00000000 --- a/snippets/zh/ascend-install.mdx +++ /dev/null @@ -1,8 +0,0 @@ -适用于与 Ascend Extension for PyTorch (torch_npu) 兼容的模型。要开始使用，请确保您的环境满足[安装页面](https://ascend.github.io/docs/sources/ascend/quick_install.html)上列出的先决条件。 - -**分步指南：** - -1. 首先，如有必要，按照 torch-npu 安装页面中指定的要求，为 Linux 安装推荐或更新的内核版本。 -2. 继续安装 Ascend Basekit，其中包括驱动程序、固件和 CANN，按照您特定平台的说明进行操作。 -3. 接下来，按照[安装页面](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch)上的平台特定说明安装 torch-npu 所需的软件包。 -4. 最后，按照 Linux 的 ComfyUI 手动安装指南进行操作。安装所有组件后，您可以按照前面所述运行 ComfyUI。 From 51f7c4f126be3fa639ca5ec9451e67a11d79dc06 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:52:03 +0000 Subject: [PATCH 51/82] Delete snippets/zh/cambricon-install.mdx --- snippets/zh/cambricon-install.mdx | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 snippets/zh/cambricon-install.mdx diff --git a/snippets/zh/cambricon-install.mdx b/snippets/zh/cambricon-install.mdx deleted file mode 100644 index 7e7cb9f9..00000000 --- a/snippets/zh/cambricon-install.mdx +++ /dev/null @@ -1,7 +0,0 @@ -适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。 - -**分步指南：** - -1. 按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html)上的平台特定说明安装 Cambricon CNToolkit -2. 接下来，按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html)上的说明安装 PyTorch(torch_mlu) -3. 通过运行 `python main.py` 启动 ComfyUI From bc686deb3e6c7cf51438d1ffb1f08776925074fa Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:52:08 +0000 Subject: [PATCH 52/82] Delete snippets/zh/mac-silicon-install.mdx --- snippets/zh/mac-silicon-install.mdx | 3 --- 1 file changed, 3 deletions(-) delete mode 100644 snippets/zh/mac-silicon-install.mdx diff --git a/snippets/zh/mac-silicon-install.mdx b/snippets/zh/mac-silicon-install.mdx deleted file mode 100644 index 7b247626..00000000 --- a/snippets/zh/mac-silicon-install.mdx +++ /dev/null @@ -1,3 +0,0 @@ -``` bash -conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly -``` \ No newline at end of file From 1fbe5b8b8904608808f5c191a5e57125c61c4a92 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:58:01 +0000 Subject: [PATCH 53/82] Update installation/manual_install.mdx --- installation/manual_install.mdx | 351 ++++++++++++++++++++++++++++++-- 1 file changed, 339 insertions(+), 12 deletions(-) diff --git a/installation/manual_install.mdx b/installation/manual_install.mdx index e0495352..d9b851c2 100644 --- a/installation/manual_install.mdx +++ b/installation/manual_install.mdx @@ -5,13 +5,6 @@ icon: "wrench" sidebarTitle: "Manual Installation" --- -import GitClone from "/snippets/git-clone.mdx"; -import Conda from "/snippets/conda.mdx"; -import PipInstall from "/snippets/pip-install.mdx"; -import InstallGpuDependencies from "/snippets/install-gpu-dependencies.mdx"; -import RunComfy from "/snippets/run-comfy.mdx"; -import AddExternalModels from "/snippets/install/add-external-models.mdx" - For the installation of ComfyUI, it is mainly divided into several steps: 1. Create a virtual environment(avoid polluting the system-level Python environment) 2. Clone the ComfyUI code repository @@ -32,7 +25,14 @@ You can also refer to [ComfyUI CLI](/comfy-cli/getting-started) to install Comfy Independent virtual environments are necessary because ComfyUI's dependencies may conflict with other dependencies on the system, and it can also avoid polluting the system-level Python environment. - +[Install Miniconda](https://docs.anaconda.com/free/miniconda/index.html#latest-miniconda-installer-links). This will help you install the correct versions of Python and other libraries needed by ComfyUI. + +Create an environment with Conda. + +``` +conda create -n comfyenv +conda activate comfyenv +``` ## Clone the ComfyUI code repository @@ -57,13 +57,162 @@ git clone git@github.com:comfyanonymous/ComfyUI.git - + Install GPU Dependencies + + +Nvidia users should install stable pytorch using this command: + +```bash +pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 +``` + +Alternatively, you can install the nightly version of PyTorch. + + +Install Nightly version (might be more risky) + +This is the command to install pytorch nightly instead which might have performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 +``` + + + +If you get the "Torch not compiled with CUDA enabled" error, uninstall torch with: + +```bash +pip uninstall torch +``` + +And install it again with the command above. + + + +AMD users can install rocm and pytorch with pip if you don't have it already installed, this is the command to install the stable version: + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 +``` + +Alternatively, you can install the nightly version of PyTorch. + + +Install Nightly version (might be more risky) + +This is the command to install the nightly with ROCm 7.0 which might have some performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 +``` + + + + +Experimental support for Windows and Linux. RDNA 3, 3.5 and 4 only. + +These have less hardware support than the builds above but they work on Windows. You also need to install the pytorch version specific to your hardware. + + +**RDNA 3 (RX 7000 series):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ +``` + +**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ +``` + +**RDNA 4 (RX 9000 series):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ +``` + + +Intel Arc GPU users can install native PyTorch with torch.xpu support using pip. More information can be found [here](https://pytorch.org/docs/main/notes/get_start_xpu.html). + +**Option 1: Install PyTorch xpu** + +To install PyTorch xpu, use the following command: + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu +``` + + +Install Nightly version (might be more risky) + +This is the command to install the Pytorch xpu nightly which might have some performance improvements: + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu +``` + + +**Option 2: Intel Extension for PyTorch (IPEX)** + +Alternatively, Intel GPUs supported by Intel Extension for PyTorch (IPEX) can leverage IPEX for improved performance. + +Visit [Installation](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu) for more information. + + +You can install ComfyUI in Apple Mac silicon (M1 or M2) with any recent macOS version. + +Install pytorch nightly. For instructions, read the [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer guide (make sure to install the latest pytorch nightly). + +```bash +conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly +``` + + +Remember to add your models, VAE, LoRAs etc. to the corresponding Comfy folders (models/checkpoints, models/vae, etc.). + + + +For models compatible with Ascend Extension for PyTorch (torch_npu). To get started, ensure your environment meets the prerequisites outlined on the [installation](https://ascend.github.io/docs/sources/ascend/quick_install.html) page. + +**Step-by-step guide:** + +1. Begin by installing the recommended or newer kernel version for Linux as specified in the Installation page of torch-npu, if necessary. +2. Proceed with the installation of Ascend Basekit, which includes the driver, firmware, and CANN, following the instructions provided for your specific platform. +3. Next, install the necessary packages for torch-npu by adhering to the platform-specific instructions on the [Installation](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch) page. +4. Finally, follow the ComfyUI manual installation guide for Linux. Once all components are installed, you can run ComfyUI as described earlier. + + +For models compatible with Cambricon Extension for PyTorch (torch_mlu). + +**Step-by-step guide:** + +1. Install the Cambricon CNToolkit by adhering to the platform-specific instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html) +2. Next, install the PyTorch(torch_mlu) following the instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html) +3. Launch ComfyUI by running `python main.py` + + +For models compatible with Iluvatar Extension for PyTorch. + +**Step-by-step guide:** + +1. Install the Iluvatar Corex Toolkit by adhering to the platform-specific instructions on the [Installation](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536) +2. Launch ComfyUI by running `python main.py` + - + ```bash +cd ComfyUI +pip install -r requirements.txt +``` - + Start the application + +``` +cd ComfyUI +python main.py +``` @@ -88,4 +237,182 @@ git clone git@github.com:comfyanonymous/ComfyUI.git - \ No newline at end of file +## Adding Extra Model Paths + +If you want to manage your model files outside of `ComfyUI/models`, you may have the following reasons: + +- You have multiple ComfyUI instances and want them to share model files to save disk space +- You have different types of GUI programs (such as WebUI) and want them to use the same model files +- Model files cannot be recognized or found + +We provide a way to add extra model search paths via the `extra_model_paths.yaml` configuration file + +### Open Config File + + + + For the ComfyUI version such as [portable](/installation/comfyui_portable_windows) and [manual](/installation/manual_install), you can find an example file named `extra_model_paths.yaml.example` in the root directory of ComfyUI: + ``` + ComfyUI/extra_model_paths.yaml.example + ``` + + Copy and rename it to `extra_model_paths.yaml` for use. Keep it in ComfyUI's root directory at `ComfyUI/extra_model_paths.yaml`. + You can also find the config example file [here](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) + + + + If you are using the [ComfyUI Desktop](/installation/desktop/windows) application, you can follow the image below to open the extra model config file: + + ![Open Config File](/images/desktop/extra_model_paths.jpg) + + Or open it directly at: + + + + ``` + C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml + ``` + + + ``` + ~/Library/Application Support/ComfyUI/extra_models_config.yaml + ``` + + + + You should keep the file in the same directory, should not move these files to other places. + + + +If the file does not exist, you can create it yourself with any text editor. + +### Example Structure + +Suppose you want to add the following model paths to ComfyUI: + +``` +📁 YOUR_PATH/ + ├── 📁models/ + | ├── 📁 lora/ + | │ └── xxxxx.safetensors + | ├── 📁 checkpoints/ + | │ └── xxxxx.safetensors + | ├── 📁 vae/ + | │ └── xxxxx.safetensors + | └── 📁 controlnet/ + | └── xxxxx.safetensors +``` + +Then you can configure the `extra_model_paths.yaml` file like below to let ComfyUI recognize the model paths on your device: + +``` +my_custom_config: + base_path: YOUR_PATH + loras: models/loras/ + checkpoints: models/checkpoints/ + vae: models/vae/ + controlnet: models/controlnet/ +``` +or + +``` +my_custom_config: + base_path: YOUR_PATH/models/ + loras: loras + checkpoints: checkpoints + vae: vae + controlnet: controlnet +``` + + + For the desktop version, please add the configuration to the existing configuration path without overwriting the path configuration generated during installation. Please back up the corresponding file before modification, so that you can restore it when you make a mistake. + + +Or you can refer to the default [extra_model_paths.yaml.example](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) for more configuration options. After saving, you need to **restart ComfyUI** for the changes to take effect. + +Below is the original config example: + +```yaml +#Rename this to extra_model_paths.yaml and ComfyUI will load it + + +#config for a1111 ui +#all you have to do is change the base_path to where yours is installed +a111: + base_path: path/to/stable-diffusion-webui/ + + checkpoints: models/Stable-diffusion + configs: models/Stable-diffusion + vae: models/VAE + loras: | + models/Lora + models/LyCORIS + upscale_models: | + models/ESRGAN + models/RealESRGAN + models/SwinIR + embeddings: embeddings + hypernetworks: models/hypernetworks + controlnet: models/ControlNet + +#config for comfyui +#your base path should be either an existing comfy install or a central folder where you store all of your models, loras, etc. + +#comfyui: +# base_path: path/to/comfyui/ +# # You can use is_default to mark that these folders should be listed first, and used as the default dirs for eg downloads +# #is_default: true +# checkpoints: models/checkpoints/ +# clip: models/clip/ +# clip_vision: models/clip_vision/ +# configs: models/configs/ +# controlnet: models/controlnet/ +# diffusion_models: | +# models/diffusion_models +# models/unet +# embeddings: models/embeddings/ +# loras: models/loras/ +# upscale_models: models/upscale_models/ +# vae: models/vae/ + +#other_ui: +# base_path: path/to/ui +# checkpoints: models/checkpoints +# gligen: models/gligen +# custom_nodes: path/custom_nodes + +``` + +For example, if your WebUI is located at `D:\stable-diffusion-webui\`, you can modify the corresponding configuration to +```yaml +a111: + base_path: D:\stable-diffusion-webui\ + checkpoints: models/Stable-diffusion + configs: models/Stable-diffusion + vae: models/VAE + loras: | + models/Lora + models/LyCORIS + upscale_models: | + models/ESRGAN + models/RealESRGAN + models/SwinIR + embeddings: embeddings + hypernetworks: models/hypernetworks + controlnet: models/ControlNet +``` + +### Add Extra Custom Nodes Path + +Besides adding external models, you can also add custom nodes paths that are not in the default path of ComfyUI + + + Please note that this will not change the default installation path of custom nodes, but will add an extra path search when starting ComfyUI. You still need to complete the installation of custom node dependencies in the corresponding environment to ensure the integrity of the running environment. + + +Below is a simple configuration example (MacOS), please modify it according to your actual situation and add it to the corresponding configuration file, save it and restart ComfyUI for the changes to take effect: + +```yaml +my_custom_nodes: + custom_nodes: /Users/your_username/Documents/extra_custom_nodes +``` From eb522c6751888c245092d8bcb35b4510c7d5e044 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:32 +0000 Subject: [PATCH 54/82] Update zh-CN/installation/manual_install.mdx --- zh-CN/installation/manual_install.mdx | 333 +++++++++++++++++++++++++- 1 file changed, 320 insertions(+), 13 deletions(-) diff --git a/zh-CN/installation/manual_install.mdx b/zh-CN/installation/manual_install.mdx index ba968afe..a164456a 100644 --- a/zh-CN/installation/manual_install.mdx +++ b/zh-CN/installation/manual_install.mdx @@ -5,13 +5,6 @@ icon: "wrench" sidebarTitle: "手动安装" --- -import GitClone from "/snippets/zh/git-clone.mdx"; -import Conda from "/snippets/zh/conda.mdx"; -import PipInstall from "/snippets/zh/pip-install.mdx"; -import InstallGpuDependencies from "/snippets/zh/install-gpu-dependencies.mdx"; -import RunComfy from "/snippets/zh/run-comfy.mdx"; -import AddExternalModels from "/snippets/zh/install/add-external-models.mdx" - 对于 ComfyUI 的安装， 主要分为几个步骤 1. 创建一个虚拟环境(避免污染系统级 Python 环境) 2. 克隆 ComfyUI 代码仓库 @@ -19,7 +12,7 @@ import AddExternalModels from "/snippets/zh/install/add-external-models.mdx" 4. 启动 ComfyUI -Python 3.13 支持非常好。如果你在 3.13 上遇到某些自定义节点依赖问题，可以尝试使用 3.12。 +Python 3.13 支持非常好。如果你在 3.13 上遇到某些自定义节点依赖问题,可以尝试使用 3.12。 Python 3.14 可以工作，但需要在 requirements.txt 文件中注释掉 `kornia` 依赖（会导致 canny 节点失效），不建议使用。 @@ -31,7 +24,15 @@ Python 3.14 可以工作，但需要在 requirements.txt 文件中注释掉 `kor 独立的虚拟环境是必要的，因为 ComfyUI 的依赖可能会与系统上的其他依赖冲突，也可以避免对系统级 Python 环境的污染。 - + +[Install Miniconda](https://docs.anaconda.com/free/miniconda/index.html#latest-miniconda-installer-links). 这将帮助您安装 ComfyUI 所需的正确版本的 Python 和其他库。 + +使用 Conda 创建一个环境。 + +``` +conda create -n comfyenv +conda activate comfyenv +``` ## 克隆代码仓库 @@ -57,13 +58,162 @@ git clone git@github.com:comfyanonymous/ComfyUI.git ## 安装GPU 及 ComfyUI 依赖 - + 安装 GPU 依赖 + + +Nvidia 用户应使用以下命令安装稳定版 pytorch： + +```bash +pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 +``` + +或者，您可以安装 PyTorch 的夜间版本。 + + +安装夜间版本（可能风险更大） + +这是安装 pytorch 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 +``` + + + +如果您遇到 "Torch not compiled with CUDA enabled" 错误，请使用以下命令卸载 torch： + +```bash +pip uninstall torch +``` + +然后使用上述命令重新安装。 + + + +AMD 用户可以使用 pip 安装 rocm 和 pytorch（如果尚未安装），这是安装稳定版本的命令： + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 +``` + +或者，您可以安装 PyTorch 的夜间版本。 + + +安装夜间版本（可能风险更大） + +这是安装 ROCm 7.0 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 +``` + + + + +Windows 和 Linux 的实验性支持。仅支持 RDNA 3、3.5 和 4。 + +这些版本的硬件支持比上述版本少，但它们可以在 Windows 上运行。您还需要安装特定于您硬件的 PyTorch 版本。 + + +**RDNA 3 (RX 7000 系列):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ +``` + +**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ +``` + +**RDNA 4 (RX 9000 系列):** + +```bash +pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ +``` + + +Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在[这里](https://pytorch.org/docs/main/notes/get_start_xpu.html)找到。 + +**选项 1: 安装 PyTorch xpu** + +要安装 PyTorch xpu，请使用以下命令： + +```bash +pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu +``` + + +安装夜间版本（可能风险更大） + +这是安装 PyTorch xpu 夜间版本的命令，可能会有一些性能改进： + +```bash +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu +``` + + +**选项 2: Intel Extension for PyTorch (IPEX)** + +或者，Intel Extension for PyTorch (IPEX) 支持的 Intel GPU 可以利用 IPEX 来提高性能。 + +访问[安装页面](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu)了解更多信息。 + + +您可以在任何最新的 macOS 版本上的 Apple Mac silicon（M1 或 M2）中安装 ComfyUI。 + +安装 pytorch nightly。有关说明，请阅读 [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer 指南（确保安装最新的 pytorch nightly）。 + +```bash +conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly +``` + + +记得将您的模型、VAE、LoRA 等添加到相应的 Comfy 文件夹（models/checkpoints、models/vae 等）。 + + + +适用于与 Ascend Extension for PyTorch (torch_npu) 兼容的模型。要开始使用，请确保您的环境满足[安装页面](https://ascend.github.io/docs/sources/ascend/quick_install.html)上列出的先决条件。 + +**分步指南：** + +1. 首先，如有必要，按照 torch-npu 安装页面中指定的要求，为 Linux 安装推荐或更新的内核版本。 +2. 继续安装 Ascend Basekit，其中包括驱动程序、固件和 CANN，按照您特定平台的说明进行操作。 +3. 接下来，按照[安装页面](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch)上的平台特定说明安装 torch-npu 所需的软件包。 +4. 最后，按照 Linux 的 ComfyUI 手动安装指南进行操作。安装所有组件后，您可以按照前面所述运行 ComfyUI。 + + +适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。 + +**分步指南：** + +1. 按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html)上的平台特定说明安装 Cambricon CNToolkit +2. 接下来，按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html)上的说明安装 PyTorch(torch_mlu) +3. 通过运行 `python main.py` 启动 ComfyUI + + +适用于与 Iluvatar Extension for PyTorch 兼容的模型。 + +**分步指南：** + +1. 按照[安装页面](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536)上的平台特定说明安装 Iluvatar Corex Toolkit +2. 通过运行 `python main.py` 启动 ComfyUI + - + ```bash +cd ComfyUI +pip install -r requirements.txt +``` - + 启动 ComfyUI + +``` +cd ComfyUI +python main.py +``` @@ -88,4 +238,161 @@ git clone git@github.com:comfyanonymous/ComfyUI.git - \ No newline at end of file +## 添加外部模型路径 + +如果你想要在 `ComfyUI/models` 之外管理你的模型文件，可能出于以下原因: + +- 你有多个 ComfyUI 实例，你想要让这些实例共享模型文件，从而减少磁盘占用 +- 你有多个不同的类型的 GUI 程序，如：WebUI, 你想要他们共用模型文件 +- 模型文件无法被识别或读取到 + +我们提供了通过 `extra_model_paths.yaml` 配置文件来添加额外模型搜索路径的方法。 + +### 不同 ComfyUI 版本配置文件位置 + + + + 对于[便携版](/zh-CN/installation/comfyui_portable_windows)和[手动安装](/zh-CN/installation/manual_install)的 ComfyUI版本，你可以在 ComfyUI 的根目录下找到 `extra_model_paths.yaml.example` 的示例文件 + ``` + ComfyUI/extra_model_paths.yaml.example + ``` + 复制并重命名为 `extra_model_paths.yaml` 来使用, 并保持在 ComfyUI 的根目录下, 路径应该是 `ComfyUI/extra_model_paths.yaml` + + 你也可以在 [这里](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) 找到配置示例文件 + + + + 如果你使用的是 ComfyUI 桌面应用程序，你可以参考下图打开额外模型的配置文件： + + ![Open Config File](/images/zh/desktop/extra_model_paths.jpg) + + 或者通过下面的位置打开： + + + + ``` + C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml + ``` + + + ``` + ~/Library/Application Support/ComfyUI/extra_models_config.yaml + ``` + + + + 对应的配置文件不应该被改变 + + + +### 配置示例 + +比如，你需要额外让 ComfyUI 识别的模型文件位于下面的文件夹: + +``` +📁 YOUR_PATH/ + ├── 📁models/ + | ├── 📁 loras/ + | │ └── xxxxx.safetensors + | ├── 📁 checkpoints/ + | │ └── xxxxx.safetensors + | ├── 📁 vae/ + | │ └── xxxxx.safetensors + | └── 📁 controlnet/ + | └── xxxxx.safetensors +``` + +那么你可以进行如下的配置来让 ComfyUI 识别到你设备上的模型路径 + +``` +my_custom_config: + base_path: YOUR_PATH + loras: models/loras/ + checkpoints: models/checkpoints/ + vae: models/vae/ + controlnet: models/controlnet/ +``` + +或者使用 +``` +my_custom_config: + base_path: YOUR_PATH/models/ + loras: loras + checkpoints: checkpoints + vae: vae + controlnet: controlnet +``` + + + 对于桌面版，请在原有配置路径下新增配置，而不覆盖掉安装过程中自动生成的路径配置，请在修改前备份对应的文件，这样在你配置错误时可以及时恢复 + + +或者你也可以参考默认的 [extra_model_paths.yaml.example](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) 来配置，保存之后， 需要 **重启 ComfyUI** 才能生效。 + +下面是完整的原始的配置配置示例: + +```yaml +#Rename this to extra_model_paths.yaml and ComfyUI will load it + + +#config for a1111 ui +#all you have to do is change the base_path to where yours is installed +a111: + base_path: path/to/stable-diffusion-webui/ + + checkpoints: models/Stable-diffusion + configs: models/Stable-diffusion + vae: models/VAE + loras: | + models/Lora + models/LyCORIS + upscale_models: | + models/ESRGAN + models/RealESRGAN + models/SwinIR + embeddings: embeddings + hypernetworks: models/hypernetworks + controlnet: models/ControlNet + +#config for comfyui +#your base path should be either an existing comfy install or a central folder where you store all of your models, loras, etc. + +#comfyui: +# base_path: path/to/comfyui/ +# # You can use is_default to mark that these folders should be listed first, and used as the default dirs for eg downloads +# #is_default: true +# checkpoints: models/checkpoints/ +# clip: models/clip/ +# clip_vision: models/clip_vision/ +# configs: models/configs/ +# controlnet: models/controlnet/ +# diffusion_models: | +# models/diffusion_models +# models/unet +# embeddings: models/embeddings/ +# loras: models/loras/ +# upscale_models: models/upscale_models/ +# vae: models/vae/ + +#other_ui: +# base_path: path/to/ui +# checkpoints: models/checkpoints +# gligen: models/gligen +# custom_nodes: path/custom_nodes + +``` + +### 添加额外自定义节点路径 + +除了添加外部模型之外，你同样可以添加不在 ComfyUI 默认路径下的自定义节点路径 + + + 请注意，这并不会改变自定义节点的默认安装路径，只是在启动 ComfyUI 时会增加额外的路径搜索，你仍旧需要在对应的环境中完成自定义节点的依赖的安装，来保证其运行环境的完整性。 + + +下面是一个简单的配置示例（Mac 系统），请根据你的实际情况进行修改，并新增到对应的配置文件中，保存后需要 **重启 ComfyUI** 才能生效: + +```yaml +my_custom_nodes: + custom_nodes: /Users/your_username/Documents/extra_custom_nodes +``` From 2a4b71d47be39dc3188b2516a7467804da7957aa Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:39 +0000 Subject: [PATCH 55/82] Delete snippets/git-clone.mdx --- snippets/git-clone.mdx | 5 ----- 1 file changed, 5 deletions(-) delete mode 100644 snippets/git-clone.mdx diff --git a/snippets/git-clone.mdx b/snippets/git-clone.mdx deleted file mode 100644 index a1805546..00000000 --- a/snippets/git-clone.mdx +++ /dev/null @@ -1,5 +0,0 @@ -```bash -git clone git@github.com:comfyanonymous/ComfyUI.git -``` - -More [info](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) on git clone. From 6a48a3ad50e112d68f4160aa5fb897ebb95a84cd Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:40 +0000 Subject: [PATCH 56/82] Delete snippets/conda.mdx --- snippets/conda.mdx | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 snippets/conda.mdx diff --git a/snippets/conda.mdx b/snippets/conda.mdx deleted file mode 100644 index bdb063be..00000000 --- a/snippets/conda.mdx +++ /dev/null @@ -1,8 +0,0 @@ -[Install Miniconda](https://docs.anaconda.com/free/miniconda/index.html#latest-miniconda-installer-links). This will help you install the correct versions of Python and other libraries needed by ComfyUI. - -Create an environment with Conda. - -``` -conda create -n comfyenv -conda activate comfyenv -``` From 73cf5681b8e49ff8bf2fa574ff9835d8ecec2034 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:41 +0000 Subject: [PATCH 57/82] Delete snippets/install-gpu-dependencies.mdx --- snippets/install-gpu-dependencies.mdx | 35 --------------------------- 1 file changed, 35 deletions(-) delete mode 100644 snippets/install-gpu-dependencies.mdx diff --git a/snippets/install-gpu-dependencies.mdx b/snippets/install-gpu-dependencies.mdx deleted file mode 100644 index 13885049..00000000 --- a/snippets/install-gpu-dependencies.mdx +++ /dev/null @@ -1,35 +0,0 @@ -import AmdInstall from "/snippets/install/amd-install.mdx"; -import AmdExperimentalInstall from "/snippets/install/amd-experimental-install.mdx"; -import NvidiaInstall from "/snippets/install/nvidia-install.mdx"; -import IntelInstall from "/snippets/install/intel-install.mdx"; -import MacInstall from "/snippets/install/mac-silicon-install.mdx"; -import AscendInstall from "/snippets/install/ascend-install.mdx"; -import CambriconInstall from "/snippets/install/cambricon-install.mdx"; -import IluvatarInstall from "/snippets/install/iluvatar-install.mdx"; - -Install GPU Dependencies - - - - - - - - - - - - - - - - - - - - - - - - - From 784a6d5a703538fdfefea253481afd2def51f9c7 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:44 +0000 Subject: [PATCH 58/82] Delete snippets/install/amd-experimental-install.mdx --- snippets/install/amd-experimental-install.mdx | 23 ------------------- 1 file changed, 23 deletions(-) delete mode 100644 snippets/install/amd-experimental-install.mdx diff --git a/snippets/install/amd-experimental-install.mdx b/snippets/install/amd-experimental-install.mdx deleted file mode 100644 index 89601934..00000000 --- a/snippets/install/amd-experimental-install.mdx +++ /dev/null @@ -1,23 +0,0 @@ - -Experimental support for Windows and Linux. RDNA 3, 3.5 and 4 only. - -These have less hardware support than the builds above but they work on Windows. You also need to install the pytorch version specific to your hardware. - - -**RDNA 3 (RX 7000 series):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ -``` - -**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ -``` - -**RDNA 4 (RX 9000 series):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ -``` From 92552f5b2baa9013474b9d8e826f2b36f0064df4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:45 +0000 Subject: [PATCH 59/82] Delete snippets/install/intel-install.mdx --- snippets/install/intel-install.mdx | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 snippets/install/intel-install.mdx diff --git a/snippets/install/intel-install.mdx b/snippets/install/intel-install.mdx deleted file mode 100644 index 94af5fc5..00000000 --- a/snippets/install/intel-install.mdx +++ /dev/null @@ -1,25 +0,0 @@ -Intel Arc GPU users can install native PyTorch with torch.xpu support using pip. More information can be found [here](https://pytorch.org/docs/main/notes/get_start_xpu.html). - -**Option 1: Install PyTorch xpu** - -To install PyTorch xpu, use the following command: - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu -``` - - -Install Nightly version (might be more risky) - -This is the command to install the Pytorch xpu nightly which might have some performance improvements: - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu -``` - - -**Option 2: Intel Extension for PyTorch (IPEX)** - -Alternatively, Intel GPUs supported by Intel Extension for PyTorch (IPEX) can leverage IPEX for improved performance. - -Visit [Installation](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu) for more information. From e2207b30643e1d007c645ffb5239c4ec1917ac27 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:46 +0000 Subject: [PATCH 60/82] Delete snippets/install/ascend-install.mdx --- snippets/install/ascend-install.mdx | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 snippets/install/ascend-install.mdx diff --git a/snippets/install/ascend-install.mdx b/snippets/install/ascend-install.mdx deleted file mode 100644 index 6a686977..00000000 --- a/snippets/install/ascend-install.mdx +++ /dev/null @@ -1,8 +0,0 @@ -For models compatible with Ascend Extension for PyTorch (torch_npu). To get started, ensure your environment meets the prerequisites outlined on the [installation](https://ascend.github.io/docs/sources/ascend/quick_install.html) page. - -**Step-by-step guide:** - -1. Begin by installing the recommended or newer kernel version for Linux as specified in the Installation page of torch-npu, if necessary. -2. Proceed with the installation of Ascend Basekit, which includes the driver, firmware, and CANN, following the instructions provided for your specific platform. -3. Next, install the necessary packages for torch-npu by adhering to the platform-specific instructions on the [Installation](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch) page. -4. Finally, follow the ComfyUI manual installation guide for Linux. Once all components are installed, you can run ComfyUI as described earlier. From 6c6aa7876d3a949c31e7fba89c35cf6068108027 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:47 +0000 Subject: [PATCH 61/82] Delete snippets/zh/git-clone.mdx --- snippets/zh/git-clone.mdx | 5 ----- 1 file changed, 5 deletions(-) delete mode 100644 snippets/zh/git-clone.mdx diff --git a/snippets/zh/git-clone.mdx b/snippets/zh/git-clone.mdx deleted file mode 100644 index f13e55c1..00000000 --- a/snippets/zh/git-clone.mdx +++ /dev/null @@ -1,5 +0,0 @@ -```bash -git clone git@github.com:comfyanonymous/ComfyUI.git -``` - -更多关于[git clone](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) 的信息。 From a00de6abd69ae039e15b0872a2c4f467de5d960e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:48 +0000 Subject: [PATCH 62/82] Delete snippets/zh/conda.mdx --- snippets/zh/conda.mdx | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 snippets/zh/conda.mdx diff --git a/snippets/zh/conda.mdx b/snippets/zh/conda.mdx deleted file mode 100644 index 9147f72d..00000000 --- a/snippets/zh/conda.mdx +++ /dev/null @@ -1,8 +0,0 @@ -[Install Miniconda](https://docs.anaconda.com/free/miniconda/index.html#latest-miniconda-installer-links). 这将帮助您安装 ComfyUI 所需的正确版本的 Python 和其他库。 - -使用 Conda 创建一个环境。 - -``` -conda create -n comfyenv -conda activate comfyenv -``` From 42dbaeac7181a0081f9bf44d81d67210f27d4bc0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:50 +0000 Subject: [PATCH 63/82] Delete snippets/zh/install/amd-experimental-install.mdx --- .../zh/install/amd-experimental-install.mdx | 23 ------------------- 1 file changed, 23 deletions(-) delete mode 100644 snippets/zh/install/amd-experimental-install.mdx diff --git a/snippets/zh/install/amd-experimental-install.mdx b/snippets/zh/install/amd-experimental-install.mdx deleted file mode 100644 index 43904ed1..00000000 --- a/snippets/zh/install/amd-experimental-install.mdx +++ /dev/null @@ -1,23 +0,0 @@ - -Windows 和 Linux 的实验性支持。仅支持 RDNA 3、3.5 和 4。 - -这些版本的硬件支持比上述版本少，但它们可以在 Windows 上运行。您还需要安装特定于您硬件的 PyTorch 版本。 - - -**RDNA 3 (RX 7000 系列):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx110X-dgpu/ -``` - -**RDNA 3.5 (Strix halo/Ryzen AI Max+ 365):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx1151/ -``` - -**RDNA 4 (RX 9000 系列):** - -```bash -pip install --pre torch torchvision torchaudio --index-url https://rocm.nightlies.amd.com/v2/gfx120X-all/ -``` From a6458cc11d249d7dde82075800e6b6a2ba3facb5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:55 +0000 Subject: [PATCH 64/82] Delete snippets/pip-install.mdx --- snippets/pip-install.mdx | 4 ---- 1 file changed, 4 deletions(-) delete mode 100644 snippets/pip-install.mdx diff --git a/snippets/pip-install.mdx b/snippets/pip-install.mdx deleted file mode 100644 index 81541078..00000000 --- a/snippets/pip-install.mdx +++ /dev/null @@ -1,4 +0,0 @@ -```bash -cd ComfyUI -pip install -r requirements.txt -``` From 0bbe992be6ab30e9730dd5c9ba2dec4c46b96193 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:55 +0000 Subject: [PATCH 65/82] Delete snippets/run-comfy.mdx --- snippets/run-comfy.mdx | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 snippets/run-comfy.mdx diff --git a/snippets/run-comfy.mdx b/snippets/run-comfy.mdx deleted file mode 100644 index 1c3ef542..00000000 --- a/snippets/run-comfy.mdx +++ /dev/null @@ -1,6 +0,0 @@ -Start the application - -``` -cd ComfyUI -python main.py -``` From 48137b6ba0ea612e4efb2dfb0bdd9e4f76a31ad0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:57 +0000 Subject: [PATCH 66/82] Delete snippets/install/nvidia-install.mdx --- snippets/install/nvidia-install.mdx | 27 --------------------------- 1 file changed, 27 deletions(-) delete mode 100644 snippets/install/nvidia-install.mdx diff --git a/snippets/install/nvidia-install.mdx b/snippets/install/nvidia-install.mdx deleted file mode 100644 index 52f199f5..00000000 --- a/snippets/install/nvidia-install.mdx +++ /dev/null @@ -1,27 +0,0 @@ -Nvidia users should install stable pytorch using this command: - -```bash -pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 -``` - -Alternatively, you can install the nightly version of PyTorch. - - -Install Nightly version (might be more risky) - -This is the command to install pytorch nightly instead which might have performance improvements: - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 -``` - - - -If you get the "Torch not compiled with CUDA enabled" error, uninstall torch with: - -```bash -pip uninstall torch -``` - -And install it again with the command above. - \ No newline at end of file From 0ff118f51d24b0183e66a8191dd00cf7e0a83006 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:58 +0000 Subject: [PATCH 67/82] Delete snippets/install/mac-silicon-install.mdx --- snippets/install/mac-silicon-install.mdx | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 snippets/install/mac-silicon-install.mdx diff --git a/snippets/install/mac-silicon-install.mdx b/snippets/install/mac-silicon-install.mdx deleted file mode 100644 index 71b5e2c0..00000000 --- a/snippets/install/mac-silicon-install.mdx +++ /dev/null @@ -1,11 +0,0 @@ -You can install ComfyUI in Apple Mac silicon (M1 or M2) with any recent macOS version. - -Install pytorch nightly. For instructions, read the [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer guide (make sure to install the latest pytorch nightly). - -```bash -conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly -``` - - -Remember to add your models, VAE, LoRAs etc. to the corresponding Comfy folders (models/checkpoints, models/vae, etc.). - \ No newline at end of file From 619ed3371cb5cc821585984a58261025aabeed7a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 13:59:59 +0000 Subject: [PATCH 68/82] Delete snippets/install/cambricon-install.mdx --- snippets/install/cambricon-install.mdx | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 snippets/install/cambricon-install.mdx diff --git a/snippets/install/cambricon-install.mdx b/snippets/install/cambricon-install.mdx deleted file mode 100644 index 4b436c3f..00000000 --- a/snippets/install/cambricon-install.mdx +++ /dev/null @@ -1,7 +0,0 @@ -For models compatible with Cambricon Extension for PyTorch (torch_mlu). - -**Step-by-step guide:** - -1. Install the Cambricon CNToolkit by adhering to the platform-specific instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html) -2. Next, install the PyTorch(torch_mlu) following the instructions on the [Installation](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html) -3. Launch ComfyUI by running `python main.py` From d79efb31717eb94058a47d2acc0ccf556e9b9f30 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:00 +0000 Subject: [PATCH 69/82] Delete snippets/install/iluvatar-install.mdx --- snippets/install/iluvatar-install.mdx | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 snippets/install/iluvatar-install.mdx diff --git a/snippets/install/iluvatar-install.mdx b/snippets/install/iluvatar-install.mdx deleted file mode 100644 index cc789831..00000000 --- a/snippets/install/iluvatar-install.mdx +++ /dev/null @@ -1,6 +0,0 @@ -For models compatible with Iluvatar Extension for PyTorch. - -**Step-by-step guide:** - -1. Install the Iluvatar Corex Toolkit by adhering to the platform-specific instructions on the [Installation](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536) -2. Launch ComfyUI by running `python main.py` From 13efd3f50c6d6686e0d1f7c80a3bc9b281bc2783 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:01 +0000 Subject: [PATCH 70/82] Delete snippets/zh/install/amd-install.mdx --- snippets/zh/install/amd-install.mdx | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 snippets/zh/install/amd-install.mdx diff --git a/snippets/zh/install/amd-install.mdx b/snippets/zh/install/amd-install.mdx deleted file mode 100644 index 66fdb115..00000000 --- a/snippets/zh/install/amd-install.mdx +++ /dev/null @@ -1,17 +0,0 @@ -AMD 用户可以使用 pip 安装 rocm 和 pytorch（如果尚未安装），这是安装稳定版本的命令： - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 -``` - -或者，您可以安装 PyTorch 的夜间版本。 - - -安装夜间版本（可能风险更大） - -这是安装 ROCm 7.0 夜间版本的命令，可能会有一些性能改进： - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 -``` - From 61d48569e0add14da96b38b4a1081ff030dd0d51 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:08 +0000 Subject: [PATCH 71/82] Delete snippets/install/add-external-models.mdx --- snippets/install/add-external-models.mdx | 179 ----------------------- 1 file changed, 179 deletions(-) delete mode 100644 snippets/install/add-external-models.mdx diff --git a/snippets/install/add-external-models.mdx b/snippets/install/add-external-models.mdx deleted file mode 100644 index 570e762d..00000000 --- a/snippets/install/add-external-models.mdx +++ /dev/null @@ -1,179 +0,0 @@ -## Adding Extra Model Paths - -If you want to manage your model files outside of `ComfyUI/models`, you may have the following reasons: - -- You have multiple ComfyUI instances and want them to share model files to save disk space -- You have different types of GUI programs (such as WebUI) and want them to use the same model files -- Model files cannot be recognized or found - -We provide a way to add extra model search paths via the `extra_model_paths.yaml` configuration file - -### Open Config File - - - - For the ComfyUI version such as [portable](/installation/comfyui_portable_windows) and [manual](/installation/manual_install), you can find an example file named `extra_model_paths.yaml.example` in the root directory of ComfyUI: - ``` - ComfyUI/extra_model_paths.yaml.example - ``` - - Copy and rename it to `extra_model_paths.yaml` for use. Keep it in ComfyUI's root directory at `ComfyUI/extra_model_paths.yaml`. - You can also find the config example file [here](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) - - - - If you are using the [ComfyUI Desktop](/installation/desktop/windows) application, you can follow the image below to open the extra model config file: - - ![Open Config File](/images/desktop/extra_model_paths.jpg) - - Or open it directly at: - - - - ``` - C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml - ``` - - - ``` - ~/Library/Application Support/ComfyUI/extra_models_config.yaml - ``` - - - - You should keep the file in the same directory, should not move these files to other places. - - - -If the file does not exist, you can create it yourself with any text editor. - -### Example Structure - -Suppose you want to add the following model paths to ComfyUI: - -``` -📁 YOUR_PATH/ - ├── 📁models/ - | ├── 📁 lora/ - | │ └── xxxxx.safetensors - | ├── 📁 checkpoints/ - | │ └── xxxxx.safetensors - | ├── 📁 vae/ - | │ └── xxxxx.safetensors - | └── 📁 controlnet/ - | └── xxxxx.safetensors -``` - -Then you can configure the `extra_model_paths.yaml` file like below to let ComfyUI recognize the model paths on your device: - -``` -my_custom_config: - base_path: YOUR_PATH - loras: models/loras/ - checkpoints: models/checkpoints/ - vae: models/vae/ - controlnet: models/controlnet/ -``` -or - -``` -my_custom_config: - base_path: YOUR_PATH/models/ - loras: loras - checkpoints: checkpoints - vae: vae - controlnet: controlnet -``` - - - For the desktop version, please add the configuration to the existing configuration path without overwriting the path configuration generated during installation. Please back up the corresponding file before modification, so that you can restore it when you make a mistake. - - -Or you can refer to the default [extra_model_paths.yaml.example](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) for more configuration options. After saving, you need to **restart ComfyUI** for the changes to take effect. - -Below is the original config example: - -```yaml -#Rename this to extra_model_paths.yaml and ComfyUI will load it - - -#config for a1111 ui -#all you have to do is change the base_path to where yours is installed -a111: - base_path: path/to/stable-diffusion-webui/ - - checkpoints: models/Stable-diffusion - configs: models/Stable-diffusion - vae: models/VAE - loras: | - models/Lora - models/LyCORIS - upscale_models: | - models/ESRGAN - models/RealESRGAN - models/SwinIR - embeddings: embeddings - hypernetworks: models/hypernetworks - controlnet: models/ControlNet - -#config for comfyui -#your base path should be either an existing comfy install or a central folder where you store all of your models, loras, etc. - -#comfyui: -# base_path: path/to/comfyui/ -# # You can use is_default to mark that these folders should be listed first, and used as the default dirs for eg downloads -# #is_default: true -# checkpoints: models/checkpoints/ -# clip: models/clip/ -# clip_vision: models/clip_vision/ -# configs: models/configs/ -# controlnet: models/controlnet/ -# diffusion_models: | -# models/diffusion_models -# models/unet -# embeddings: models/embeddings/ -# loras: models/loras/ -# upscale_models: models/upscale_models/ -# vae: models/vae/ - -#other_ui: -# base_path: path/to/ui -# checkpoints: models/checkpoints -# gligen: models/gligen -# custom_nodes: path/custom_nodes - -``` - -For example, if your WebUI is located at `D:\stable-diffusion-webui\`, you can modify the corresponding configuration to -```yaml -a111: - base_path: D:\stable-diffusion-webui\ - checkpoints: models/Stable-diffusion - configs: models/Stable-diffusion - vae: models/VAE - loras: | - models/Lora - models/LyCORIS - upscale_models: | - models/ESRGAN - models/RealESRGAN - models/SwinIR - embeddings: embeddings - hypernetworks: models/hypernetworks - controlnet: models/ControlNet -``` - -### Add Extra Custom Nodes Path - -Besides adding external models, you can also add custom nodes paths that are not in the default path of ComfyUI - - - Please note that this will not change the default installation path of custom nodes, but will add an extra path search when starting ComfyUI. You still need to complete the installation of custom node dependencies in the corresponding environment to ensure the integrity of the running environment. - - -Below is a simple configuration example (MacOS), please modify it according to your actual situation and add it to the corresponding configuration file, save it and restart ComfyUI for the changes to take effect: - -```yaml -my_custom_nodes: - custom_nodes: /Users/your_username/Documents/extra_custom_nodes -``` \ No newline at end of file From 9ff06e44eeba9c832f9a4e9a7cddb18a7916ef18 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:09 +0000 Subject: [PATCH 72/82] Delete snippets/zh/pip-install.mdx --- snippets/zh/pip-install.mdx | 4 ---- 1 file changed, 4 deletions(-) delete mode 100644 snippets/zh/pip-install.mdx diff --git a/snippets/zh/pip-install.mdx b/snippets/zh/pip-install.mdx deleted file mode 100644 index 81541078..00000000 --- a/snippets/zh/pip-install.mdx +++ /dev/null @@ -1,4 +0,0 @@ -```bash -cd ComfyUI -pip install -r requirements.txt -``` From 274b278e1b04c350cf07cdddb7f0dc84f402f5a6 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:11 +0000 Subject: [PATCH 73/82] Delete snippets/zh/install/nvidia-install.mdx --- snippets/zh/install/nvidia-install.mdx | 27 -------------------------- 1 file changed, 27 deletions(-) delete mode 100644 snippets/zh/install/nvidia-install.mdx diff --git a/snippets/zh/install/nvidia-install.mdx b/snippets/zh/install/nvidia-install.mdx deleted file mode 100644 index 33f1d5d0..00000000 --- a/snippets/zh/install/nvidia-install.mdx +++ /dev/null @@ -1,27 +0,0 @@ -Nvidia 用户应使用以下命令安装稳定版 pytorch： - -```bash -pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 -``` - -或者，您可以安装 PyTorch 的夜间版本。 - - -安装夜间版本（可能风险更大） - -这是安装 pytorch 夜间版本的命令，可能会有一些性能改进： - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu130 -``` - - - -如果您遇到 "Torch not compiled with CUDA enabled" 错误，请使用以下命令卸载 torch： - -```bash -pip uninstall torch -``` - -然后使用上述命令重新安装。 - \ No newline at end of file From 765f0357f5b90d324311257469b59ef59c4dcd69 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:17 +0000 Subject: [PATCH 74/82] Delete snippets/zh/install-gpu-dependencies.mdx --- snippets/zh/install-gpu-dependencies.mdx | 35 ------------------------ 1 file changed, 35 deletions(-) delete mode 100644 snippets/zh/install-gpu-dependencies.mdx diff --git a/snippets/zh/install-gpu-dependencies.mdx b/snippets/zh/install-gpu-dependencies.mdx deleted file mode 100644 index cb2ea180..00000000 --- a/snippets/zh/install-gpu-dependencies.mdx +++ /dev/null @@ -1,35 +0,0 @@ -import AmdInstall from "/snippets/zh/install/amd-install.mdx"; -import AmdExperimentalInstall from "/snippets/zh/install/amd-experimental-install.mdx"; -import NvidiaInstall from "/snippets/zh/install/nvidia-install.mdx"; -import IntelInstall from "/snippets/zh/install/intel-install.mdx"; -import MacInstall from "/snippets/zh/install/mac-silicon-install.mdx"; -import AscendInstall from "/snippets/zh/install/ascend-install.mdx"; -import CambriconInstall from "/snippets/zh/install/cambricon-install.mdx"; -import IluvatarInstall from "/snippets/zh/install/iluvatar-install.mdx"; - -安装 GPU 依赖 - - - - - - - - - - - - - - - - - - - - - - - - - From ceb451f4e083bf8e64ad8fb6ba0f3defd5f5454d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:18 +0000 Subject: [PATCH 75/82] Delete snippets/zh/install/intel-install.mdx --- snippets/zh/install/intel-install.mdx | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 snippets/zh/install/intel-install.mdx diff --git a/snippets/zh/install/intel-install.mdx b/snippets/zh/install/intel-install.mdx deleted file mode 100644 index 809bfc9c..00000000 --- a/snippets/zh/install/intel-install.mdx +++ /dev/null @@ -1,25 +0,0 @@ -Intel Arc GPU 用户可以使用 pip 安装支持 torch.xpu 的原生 PyTorch。更多信息可以在[这里](https://pytorch.org/docs/main/notes/get_start_xpu.html)找到。 - -**选项 1: 安装 PyTorch xpu** - -要安装 PyTorch xpu，请使用以下命令： - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu -``` - - -安装夜间版本（可能风险更大） - -这是安装 PyTorch xpu 夜间版本的命令，可能会有一些性能改进： - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu -``` - - -**选项 2: Intel Extension for PyTorch (IPEX)** - -或者，Intel Extension for PyTorch (IPEX) 支持的 Intel GPU 可以利用 IPEX 来提高性能。 - -访问[安装页面](https://intel.github.io/intel-extension-for-pytorch/index.html#installation?platform=gpu)了解更多信息。 From b70d95fb58ad971b0dde2c7802fb85815ced5c6b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:24 +0000 Subject: [PATCH 76/82] Delete snippets/install/amd-install.mdx --- snippets/install/amd-install.mdx | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 snippets/install/amd-install.mdx diff --git a/snippets/install/amd-install.mdx b/snippets/install/amd-install.mdx deleted file mode 100644 index e1e5dd22..00000000 --- a/snippets/install/amd-install.mdx +++ /dev/null @@ -1,17 +0,0 @@ -AMD users can install rocm and pytorch with pip if you don't have it already installed, this is the command to install the stable version: - -```bash -pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 -``` - -Alternatively, you can install the nightly version of PyTorch. - - -Install Nightly version (might be more risky) - -This is the command to install the nightly with ROCm 7.0 which might have some performance improvements: - -```bash -pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.0 -``` - From 2e4e6d87f9db29e6b72ae860d3dc9ce49b715c69 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:25 +0000 Subject: [PATCH 77/82] Delete snippets/zh/install/add-external-models.mdx --- snippets/zh/install/add-external-models.mdx | 158 -------------------- 1 file changed, 158 deletions(-) delete mode 100644 snippets/zh/install/add-external-models.mdx diff --git a/snippets/zh/install/add-external-models.mdx b/snippets/zh/install/add-external-models.mdx deleted file mode 100644 index d9819b4e..00000000 --- a/snippets/zh/install/add-external-models.mdx +++ /dev/null @@ -1,158 +0,0 @@ -## 添加外部模型路径 - -如果你想要在 `ComfyUI/models` 之外管理你的模型文件，可能出于以下原因: - -- 你有多个 ComfyUI 实例，你想要让这些实例共享模型文件，从而减少磁盘占用 -- 你有多个不同的类型的 GUI 程序，如：WebUI, 你想要他们共用模型文件 -- 模型文件无法被识别或读取到 - -我们提供了通过 `extra_model_paths.yaml` 配置文件来添加额外模型搜索路径的方法。 - -### 不同 ComfyUI 版本配置文件位置 - - - - 对于[便携版](/zh-CN/installation/comfyui_portable_windows)和[手动安装](/zh-CN/installation/manual_install)的 ComfyUI版本，你可以在 ComfyUI 的根目录下找到 `extra_model_paths.yaml.example` 的示例文件 - ``` - ComfyUI/extra_model_paths.yaml.example - ``` - 复制并重命名为 `extra_model_paths.yaml` 来使用, 并保持在 ComfyUI 的根目录下, 路径应该是 `ComfyUI/extra_model_paths.yaml` - - 你也可以在 [这里](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) 找到配置示例文件 - - - - 如果你使用的是 ComfyUI 桌面应用程序，你可以参考下图打开额外模型的配置文件： - - ![Open Config File](/images/zh/desktop/extra_model_paths.jpg) - - 或者通过下面的位置打开： - - - - ``` - C:\Users\YourUsername\AppData\Roaming\ComfyUI\extra_models_config.yaml - ``` - - - ``` - ~/Library/Application Support/ComfyUI/extra_models_config.yaml - ``` - - - - 对应的配置文件不应该被改变 - - - -### 配置示例 - -比如，你需要额外让 ComfyUI 识别的模型文件位于下面的文件夹: - -``` -📁 YOUR_PATH/ - ├── 📁models/ - | ├── 📁 loras/ - | │ └── xxxxx.safetensors - | ├── 📁 checkpoints/ - | │ └── xxxxx.safetensors - | ├── 📁 vae/ - | │ └── xxxxx.safetensors - | └── 📁 controlnet/ - | └── xxxxx.safetensors -``` - -那么你可以进行如下的配置来让 ComfyUI 识别到你设备上的模型路径 - -``` -my_custom_config: - base_path: YOUR_PATH - loras: models/loras/ - checkpoints: models/checkpoints/ - vae: models/vae/ - controlnet: models/controlnet/ -``` - -或者使用 -``` -my_custom_config: - base_path: YOUR_PATH/models/ - loras: loras - checkpoints: checkpoints - vae: vae - controlnet: controlnet -``` - - - 对于桌面版，请在原有配置路径下新增配置，而不覆盖掉安装过程中自动生成的路径配置，请在修改前备份对应的文件，这样在你配置错误时可以及时恢复 - - -或者你也可以参考默认的 [extra_model_paths.yaml.example](https://github.com/comfyanonymous/ComfyUI/blob/master/extra_model_paths.yaml.example) 来配置，保存之后， 需要 **重启 ComfyUI** 才能生效。 - -下面是完整的原始的配置配置示例: - -```yaml -#Rename this to extra_model_paths.yaml and ComfyUI will load it - - -#config for a1111 ui -#all you have to do is change the base_path to where yours is installed -a111: - base_path: path/to/stable-diffusion-webui/ - - checkpoints: models/Stable-diffusion - configs: models/Stable-diffusion - vae: models/VAE - loras: | - models/Lora - models/LyCORIS - upscale_models: | - models/ESRGAN - models/RealESRGAN - models/SwinIR - embeddings: embeddings - hypernetworks: models/hypernetworks - controlnet: models/ControlNet - -#config for comfyui -#your base path should be either an existing comfy install or a central folder where you store all of your models, loras, etc. - -#comfyui: -# base_path: path/to/comfyui/ -# # You can use is_default to mark that these folders should be listed first, and used as the default dirs for eg downloads -# #is_default: true -# checkpoints: models/checkpoints/ -# clip: models/clip/ -# clip_vision: models/clip_vision/ -# configs: models/configs/ -# controlnet: models/controlnet/ -# diffusion_models: | -# models/diffusion_models -# models/unet -# embeddings: models/embeddings/ -# loras: models/loras/ -# upscale_models: models/upscale_models/ -# vae: models/vae/ - -#other_ui: -# base_path: path/to/ui -# checkpoints: models/checkpoints -# gligen: models/gligen -# custom_nodes: path/custom_nodes - -``` - -### 添加额外自定义节点路径 - -除了添加外部模型之外，你同样可以添加不在 ComfyUI 默认路径下的自定义节点路径 - - - 请注意，这并不会改变自定义节点的默认安装路径，只是在启动 ComfyUI 时会增加额外的路径搜索，你仍旧需要在对应的环境中完成自定义节点的依赖的安装，来保证其运行环境的完整性。 - - -下面是一个简单的配置示例（Mac 系统），请根据你的实际情况进行修改，并新增到对应的配置文件中，保存后需要 **重启 ComfyUI** 才能生效: - -```yaml -my_custom_nodes: - custom_nodes: /Users/your_username/Documents/extra_custom_nodes -``` \ No newline at end of file From bfbb685cb2ceee0f6ec1cb4e8e8edf6b79c2b472 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:26 +0000 Subject: [PATCH 78/82] Delete snippets/zh/install/iluvatar-install.mdx --- snippets/zh/install/iluvatar-install.mdx | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 snippets/zh/install/iluvatar-install.mdx diff --git a/snippets/zh/install/iluvatar-install.mdx b/snippets/zh/install/iluvatar-install.mdx deleted file mode 100644 index ace7b154..00000000 --- a/snippets/zh/install/iluvatar-install.mdx +++ /dev/null @@ -1,6 +0,0 @@ -适用于与 Iluvatar Extension for PyTorch 兼容的模型。 - -**分步指南：** - -1. 按照[安装页面](https://support.iluvatar.com/#/DocumentCentre?id=1&nameCenter=2&productId=520117912052801536)上的平台特定说明安装 Iluvatar Corex Toolkit -2. 通过运行 `python main.py` 启动 ComfyUI From c1eecb3d23c5e2fad4eb4fb8175aa948e34b95ef Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:31 +0000 Subject: [PATCH 79/82] Delete snippets/zh/run-comfy.mdx --- snippets/zh/run-comfy.mdx | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 snippets/zh/run-comfy.mdx diff --git a/snippets/zh/run-comfy.mdx b/snippets/zh/run-comfy.mdx deleted file mode 100644 index f4bb4e9e..00000000 --- a/snippets/zh/run-comfy.mdx +++ /dev/null @@ -1,6 +0,0 @@ -启动 ComfyUI - -``` -cd ComfyUI -python main.py -``` From 2efd978b2b24752e673b06ac2489227ba7fd9a07 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:32 +0000 Subject: [PATCH 80/82] Delete snippets/zh/install/ascend-install.mdx --- snippets/zh/install/ascend-install.mdx | 8 -------- 1 file changed, 8 deletions(-) delete mode 100644 snippets/zh/install/ascend-install.mdx diff --git a/snippets/zh/install/ascend-install.mdx b/snippets/zh/install/ascend-install.mdx deleted file mode 100644 index 494329d4..00000000 --- a/snippets/zh/install/ascend-install.mdx +++ /dev/null @@ -1,8 +0,0 @@ -适用于与 Ascend Extension for PyTorch (torch_npu) 兼容的模型。要开始使用，请确保您的环境满足[安装页面](https://ascend.github.io/docs/sources/ascend/quick_install.html)上列出的先决条件。 - -**分步指南：** - -1. 首先，如有必要，按照 torch-npu 安装页面中指定的要求，为 Linux 安装推荐或更新的内核版本。 -2. 继续安装 Ascend Basekit，其中包括驱动程序、固件和 CANN，按照您特定平台的说明进行操作。 -3. 接下来，按照[安装页面](https://ascend.github.io/docs/sources/pytorch/install.html#pytorch)上的平台特定说明安装 torch-npu 所需的软件包。 -4. 最后，按照 Linux 的 ComfyUI 手动安装指南进行操作。安装所有组件后，您可以按照前面所述运行 ComfyUI。 From f3f744cb8bf3c359e3fd864449a102bdb51cf09d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:37 +0000 Subject: [PATCH 81/82] Delete snippets/zh/install/cambricon-install.mdx --- snippets/zh/install/cambricon-install.mdx | 7 ------- 1 file changed, 7 deletions(-) delete mode 100644 snippets/zh/install/cambricon-install.mdx diff --git a/snippets/zh/install/cambricon-install.mdx b/snippets/zh/install/cambricon-install.mdx deleted file mode 100644 index 7e7cb9f9..00000000 --- a/snippets/zh/install/cambricon-install.mdx +++ /dev/null @@ -1,7 +0,0 @@ -适用于与 Cambricon Extension for PyTorch (torch_mlu) 兼容的模型。 - -**分步指南：** - -1. 按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cntoolkit_3.7.2/cntoolkit_install_3.7.2/index.html)上的平台特定说明安装 Cambricon CNToolkit -2. 接下来，按照[安装页面](https://www.cambricon.com/docs/sdk_1.15.0/cambricon_pytorch_1.17.0/user_guide_1.9/index.html)上的说明安装 PyTorch(torch_mlu) -3. 通过运行 `python main.py` 启动 ComfyUI From d73699c54489cd8772866bb5985d8042372950ec Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sat, 25 Oct 2025 14:00:42 +0000 Subject: [PATCH 82/82] Delete snippets/zh/install/mac-silicon-install.mdx --- snippets/zh/install/mac-silicon-install.mdx | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 snippets/zh/install/mac-silicon-install.mdx diff --git a/snippets/zh/install/mac-silicon-install.mdx b/snippets/zh/install/mac-silicon-install.mdx deleted file mode 100644 index a37826a8..00000000 --- a/snippets/zh/install/mac-silicon-install.mdx +++ /dev/null @@ -1,11 +0,0 @@ -您可以在任何最新的 macOS 版本上的 Apple Mac silicon（M1 或 M2）中安装 ComfyUI。 - -安装 pytorch nightly。有关说明，请阅读 [Accelerated PyTorch training on Mac](https://developer.apple.com/metal/pytorch/) Apple Developer 指南（确保安装最新的 pytorch nightly）。 - -```bash -conda install pytorch-nightly::pytorch torchvision torchaudio -c pytorch-nightly -``` - - -记得将您的模型、VAE、LoRA 等添加到相应的 Comfy 文件夹（models/checkpoints、models/vae 等）。 - \ No newline at end of file