ComfyUI 硬件兼容快速上手指南【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUIComfyUI 是一个用节点连线操作扩散模型的图形化平台文生图、图生视频、3D 生成等工作流都靠它串起来。但多数人接触它的第一道坎不是连节点而是 ComfyUI 部署本身装不上、跑不动、一生成就报显存错误。根源通常只有一个——PyTorch 的计算后端NVIDIA 是 CUDAAMD 是 ROCm苹果芯片是 Metal和你的硬件没对上。下面的 ComfyUI 硬件兼容方案按固定顺序走认清硬件 → 照抄安装命令 → 查参数表 → 按症状排障全程不需要改任何配置文件。ComfyUI 部署前先看各平台最低要求与推荐路径先说结论近五年出的显卡或 M 芯片 Mac基本照装就行需要额外动环境的只有 AMD 老卡和国产加速卡用户。硬件平台最低要求推荐路径NVIDIA 显卡近 5 年主流卡驱动正常装 cu124 以上 CUDA 版 PyTorch默认跑 FP16AMD 显卡LinuxROCm 6.2 的 PyTorch 轮子装 rocm 版 PyTorch列表外的卡设架构覆盖变量Intel 显卡/核显oneAPI 2024启动时加--oneapi-device-selector gpuApple SiliconmacOS 14 及以上官方 PyTorch 直接跑Metal 后端自动启用国产 NPU昇腾/寒武纪厂商提供的 torch 扩展见文末小众加速卡一节所谓装对后端就是让import torch之后能用上你的 GPU后面所有命令都围绕这一点。三条最短路径按你的场景直接抄命令每个场景只给能直接复制的命令装完跑python main.py浏览器打开 8188 端口能看到界面就算部署成功。Windows NVIDIA 独显3 条命令装好 ComfyUI最省心的组合注意装 torch 那行必须带 cu129 源漏了会装成 CPU 版。git clone https://gitcode.com/GitHub_Trending/co/ComfyUI cd ComfyUI pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu129 pip install -r requirements.txtAMD 显卡 Linux 启动命令AMD 卡主走 ROCm 路线官方支持列表外的卡部分 RX 7000 早期批次用环境变量声明架构RDNA3 改成11.0.0。pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 export HSA_OVERRIDE_GFX_VERSION10.3.0 python main.pyMac M 芯片一条命令直接跑确认系统版本够新后在 ComfyUI 目录下执行pip install torch torchvision python main.py显存与精度怎么设ComfyUI 参数速查表8G 以上显存、主流 NVIDIA 卡默认参数基本不用动ComfyUI 的动态显存机制会自动在显存和内存之间搬模型。下面这张表收拢了全部常见手动开关只在遇到 ComfyUI 显存不足或追求速度时回来查。类别参数什么时候用显存档位默认不加参数动态显存自动分配多数人停在这里显存档位--highvram16G 显存模型常驻显存速度最快显存档位--lowvram4-8G 显存文字编码器挪到内存显存档位--novram4G 以下显存整模型卸载到内存精度默认 FP16 自动大多数 NVIDIA 卡直接可用精度--fp8_e4m3fn-unet --supports-fp8-compute仅 RTX 40 系/50 系等新架构显存再省一截精度--force-fp32老卡跑 FP16 报错、出图异常时退回注意力--use-pytorch-cross-attentionPyTorch 2.0 的稳妥选择注意力--use-sage-attention/--use-flash-attention在上一项基础上进一步提速设备选择--cuda-device 1双显卡机器指定用第二张设备选择--reserve-vram 2给系统/桌面保留 2G 显存设备选择--oneapi-device-selector gpuIntel 显卡指定走 GPU设备选择--cpu最后手段纯 CPU 兜底精度按这个顺序试默认 → 显存紧张上 FP16 → RTX 40 系再试 FP8 → 老卡报错退 FP32。想深入了解这些参数背后的判断逻辑可以看 comfy/cli_args.py 的定义和 comfy/model_management.py 里硬件检测与资源分配的实现。按症状开药方设备未找到、显存不足、出图慢、画质异常遇到报错别慌90% 的情况对号入座就能解决。启动报设备未找到或 GPU 没被识别多半是 PyTorch 装成了纯 CPU 版先验证再重装对应平台的后端。python -c import torch;print(torch.cuda.is_available())AMD 卡若装对了后端仍不识别设置export HSA_OVERRIDE_GFX_VERSION10.3.0再启动实在不行先--cpu把流程跑通再回头修环境。ComfyUI 显存不足怎么办OOM第一步永远是降显存档位而不是关程序。python main.py --lowvram还报 OOM 就换--novram或者用--reserve-vram 2把显存留给系统16G 显存反而 OOM 的多半是工作流太大减小分辨率或批次。出图速度太慢给采样阶段减半计算量NVIDIA 卡效果最明显python main.py --fp16-unet --use-pytorch-cross-attentionAMD 卡可在上一条基础上追加--force-non-blocking实测对 ROCm 有稳定提升。出图发黑、偏色等画质异常通常是 FP16 下注意力上溢先加回保险参数对比python main.py --fp32-vae --force-upcast-attention画质恢复正常就说明该卡不适合 FP16改用--force-fp32常驻即可。疑难排查报错关键词对照表记不住参数就先对关键词30 秒验证命令跑一下结果对不上再走兜底方案。报错关键词大概率原因30 秒验证命令兜底方案No CUDA GPUs are available装的是 CPU 版 PyTorchpython -c import torch;print(torch.version.cuda)按 CUDA 路径重装 torchout of memory显存超发nvidia-smi看剩余显存--novram或--cpuHIP error/ Triton 相关ROCm 版本与显卡不匹配python -c import torch;print(torch.version.hip)设HSA_OVERRIDE_GFX_VERSIONmps 不支持某算子PyTorch 版本过旧pip show torch看版本升级到 2.6 官方版启动长时间卡在加载模型机械硬盘读模型太慢查看models/所在盘符类型模型目录挪到 SSD加--fast-disk昇腾、寒武纪等国产加速卡怎么接ComfyUI 启动时会按顺序探测 torch_npu 和 torch_mlu检测到已安装就自动把计算路由到 NPU/MLU启动参数与 CUDA 环境完全一致属于装了就能用的级别。你需要做的只是把 PyTorch 换成厂商提供的轮子再装对应扩展二选一按你的卡执行pip install torch_npu pip install torch_mlu之后照常python main.py启动即可。收尾按你的硬件执行第一步回到开头平台表找到你所在的那一行按推荐路径装带正确后端的 PyTorch。装完先跑python -c import torch;print(torch.cuda.is_available())验证设备可见再启动 main.py。平时不加任何参数只有按症状查过表也解决不了时才考虑动精度和显存档位。【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ComfyUI 硬件兼容快速上手指南【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUIComfyUI 是一个用节点连线操作扩散模型的图形化平台文生图、图生视频、3D 生成等工作流都靠它串起来。但多数人接触它的第一道坎不是连节点而是 ComfyUI 部署本身装不上、跑不动、一生成就报显存错误。根源通常只有一个——PyTorch 的计算后端NVIDIA 是 CUDAAMD 是 ROCm苹果芯片是 Metal和你的硬件没对上。下面的 ComfyUI 硬件兼容方案按固定顺序走认清硬件 → 照抄安装命令 → 查参数表 → 按症状排障全程不需要改任何配置文件。ComfyUI 部署前先看各平台最低要求与推荐路径先说结论近五年出的显卡或 M 芯片 Mac基本照装就行需要额外动环境的只有 AMD 老卡和国产加速卡用户。硬件平台最低要求推荐路径NVIDIA 显卡近 5 年主流卡驱动正常装 cu124 以上 CUDA 版 PyTorch默认跑 FP16AMD 显卡LinuxROCm 6.2 的 PyTorch 轮子装 rocm 版 PyTorch列表外的卡设架构覆盖变量Intel 显卡/核显oneAPI 2024启动时加--oneapi-device-selector gpuApple SiliconmacOS 14 及以上官方 PyTorch 直接跑Metal 后端自动启用国产 NPU昇腾/寒武纪厂商提供的 torch 扩展见文末小众加速卡一节所谓装对后端就是让import torch之后能用上你的 GPU后面所有命令都围绕这一点。三条最短路径按你的场景直接抄命令每个场景只给能直接复制的命令装完跑python main.py浏览器打开 8188 端口能看到界面就算部署成功。Windows NVIDIA 独显3 条命令装好 ComfyUI最省心的组合注意装 torch 那行必须带 cu129 源漏了会装成 CPU 版。git clone https://gitcode.com/GitHub_Trending/co/ComfyUI cd ComfyUI pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu129 pip install -r requirements.txtAMD 显卡 Linux 启动命令AMD 卡主走 ROCm 路线官方支持列表外的卡部分 RX 7000 早期批次用环境变量声明架构RDNA3 改成11.0.0。pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm6.4 export HSA_OVERRIDE_GFX_VERSION10.3.0 python main.pyMac M 芯片一条命令直接跑确认系统版本够新后在 ComfyUI 目录下执行pip install torch torchvision python main.py显存与精度怎么设ComfyUI 参数速查表8G 以上显存、主流 NVIDIA 卡默认参数基本不用动ComfyUI 的动态显存机制会自动在显存和内存之间搬模型。下面这张表收拢了全部常见手动开关只在遇到 ComfyUI 显存不足或追求速度时回来查。类别参数什么时候用显存档位默认不加参数动态显存自动分配多数人停在这里显存档位--highvram16G 显存模型常驻显存速度最快显存档位--lowvram4-8G 显存文字编码器挪到内存显存档位--novram4G 以下显存整模型卸载到内存精度默认 FP16 自动大多数 NVIDIA 卡直接可用精度--fp8_e4m3fn-unet --supports-fp8-compute仅 RTX 40 系/50 系等新架构显存再省一截精度--force-fp32老卡跑 FP16 报错、出图异常时退回注意力--use-pytorch-cross-attentionPyTorch 2.0 的稳妥选择注意力--use-sage-attention/--use-flash-attention在上一项基础上进一步提速设备选择--cuda-device 1双显卡机器指定用第二张设备选择--reserve-vram 2给系统/桌面保留 2G 显存设备选择--oneapi-device-selector gpuIntel 显卡指定走 GPU设备选择--cpu最后手段纯 CPU 兜底精度按这个顺序试默认 → 显存紧张上 FP16 → RTX 40 系再试 FP8 → 老卡报错退 FP32。想深入了解这些参数背后的判断逻辑可以看 comfy/cli_args.py 的定义和 comfy/model_management.py 里硬件检测与资源分配的实现。按症状开药方设备未找到、显存不足、出图慢、画质异常遇到报错别慌90% 的情况对号入座就能解决。启动报设备未找到或 GPU 没被识别多半是 PyTorch 装成了纯 CPU 版先验证再重装对应平台的后端。python -c import torch;print(torch.cuda.is_available())AMD 卡若装对了后端仍不识别设置export HSA_OVERRIDE_GFX_VERSION10.3.0再启动实在不行先--cpu把流程跑通再回头修环境。ComfyUI 显存不足怎么办OOM第一步永远是降显存档位而不是关程序。python main.py --lowvram还报 OOM 就换--novram或者用--reserve-vram 2把显存留给系统16G 显存反而 OOM 的多半是工作流太大减小分辨率或批次。出图速度太慢给采样阶段减半计算量NVIDIA 卡效果最明显python main.py --fp16-unet --use-pytorch-cross-attentionAMD 卡可在上一条基础上追加--force-non-blocking实测对 ROCm 有稳定提升。出图发黑、偏色等画质异常通常是 FP16 下注意力上溢先加回保险参数对比python main.py --fp32-vae --force-upcast-attention画质恢复正常就说明该卡不适合 FP16改用--force-fp32常驻即可。疑难排查报错关键词对照表记不住参数就先对关键词30 秒验证命令跑一下结果对不上再走兜底方案。报错关键词大概率原因30 秒验证命令兜底方案No CUDA GPUs are available装的是 CPU 版 PyTorchpython -c import torch;print(torch.version.cuda)按 CUDA 路径重装 torchout of memory显存超发nvidia-smi看剩余显存--novram或--cpuHIP error/ Triton 相关ROCm 版本与显卡不匹配python -c import torch;print(torch.version.hip)设HSA_OVERRIDE_GFX_VERSIONmps 不支持某算子PyTorch 版本过旧pip show torch看版本升级到 2.6 官方版启动长时间卡在加载模型机械硬盘读模型太慢查看models/所在盘符类型模型目录挪到 SSD加--fast-disk昇腾、寒武纪等国产加速卡怎么接ComfyUI 启动时会按顺序探测 torch_npu 和 torch_mlu检测到已安装就自动把计算路由到 NPU/MLU启动参数与 CUDA 环境完全一致属于装了就能用的级别。你需要做的只是把 PyTorch 换成厂商提供的轮子再装对应扩展二选一按你的卡执行pip install torch_npu pip install torch_mlu之后照常python main.py启动即可。收尾按你的硬件执行第一步回到开头平台表找到你所在的那一行按推荐路径装带正确后端的 PyTorch。装完先跑python -c import torch;print(torch.cuda.is_available())验证设备可见再启动 main.py。平时不加任何参数只有按症状查过表也解决不了时才考虑动精度和显存档位。【免费下载链接】ComfyUIThe most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface.项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
