- NVIDIA 显卡
由于 ComfyUI 桌面版 仍旧处于 Beta 状态,实际的安装过程可能会发生变化
ComfyUI 桌面版(Windows)下载
请点击下面的按钮下载对应的针对 Windows 系统的 ComfyUI 桌面版 安装包Download for Windows (NVIDIA)
ComfyUI 桌面版安装步骤
双击下载到的安装包文件,首先将会执行一次自动安装,并在桌面生成一个 ComfyUI 桌面版 的快捷方式
ComfyUI 桌面版初始化流程
1
开始界面

2
Select GPU(GPU选择)

- Nvidia 显卡(推荐): 直接支持使用 pytorch 和 CUDA
- Manual Configuration 手动配置: 你需要手动安装和配置 python 运行环境,除非你知道应该如何配置,否则请不要选择
- Enable CPU Mode 启用 CPU 模式: 仅适用于开发人员和特殊情况,除非你确定你需要使用这个模式,否则请不要选择
3
Install location(安装位置)

- Python 虚拟环境
- Models 模型文件
- Custom Nodes 自定义节点
- 请选择固态硬盘作为安装位置,这将提高 ComfyUI 访问模型的速度。
- 请新建一个单独的空白文件夹作为 ComfyUI 的安装目录
- 请保证对应磁盘至少有 15G 左右的磁盘空间,以保证 ComfyUI Desktop 的安装
ComfyUI 并非所有文件都安装在此目录下,部分文件依然会安装在 C 盘,后期如需卸载,你可以参考本篇指南的卸载部分完成完整的 ComfyUI 桌面版的卸载
4
Migrate from Existing Installation(从已有安装迁移 - 可选)

- User Files 用户文件
- Models 模型文件: 不会进行复制,只是与桌面版进行关联
- Custom Nodes 自定义节点: 自定义节点将会重新进行安装
5
Desktop Setting(桌面版设置)

- Automatic Updates 自动更新: 是否设置在 ComfyUI 更新可用时自动更新
- Usage Metrics 使用情况分析: 如果启用,我们将收集匿名的使用数据 用于帮助我们改进 ComfyUI
-
Mirror Settings 镜像设置: 由于程序需要联网下载 Python 完成相关环境安装,如果你在安装时候也如图所示出现了红色的❌,提示这可能会导致后续安装过程的失败,则请参考下面步骤进行处理
Python 安装镜像
如果默认镜像无法使用,请尝试使用下面的镜像python-build-standalone
仓库releases的镜像地址PyPI 镜像
- 阿里云:https://mirrors.aliyun.com/pypi/simple/
- 腾讯云:https://mirrors.cloud.tencent.com/pypi/simple/
- 中国科技大学:https://pypi.mirrors.ustc.edu.cn/simple/
- 上海交通大学:https://pypi.sjtu.edu.cn/simple/
Torch 镜像
6
完成安装
如果一切无误,安装程序将完成安装并自动进入 ComfyUI 桌面版界面, 则说明已经安装成功

进行第一次图片生成
安装成功后,你可以参考访问下面的章节,开始你的 ComfyUI 之路。进行第一次图片生成
本教程将引导你完成第一次的模型安装以及对应的文本到图片的生成
如何更新 ComfyUI 桌面版
目前 ComfyUI 桌面版更新采用自动检测更新,请确保在设置中已经启用自动更新
菜单
—> 帮助
—> 检查更新
中选择手动检查是否有可用的更新

添加外部模型路径
如果你想要在ComfyUI/models
之外管理你的模型文件,可能出于以下原因:
- 你有多个 ComfyUI 实例,你想要让这些实例共享模型文件,从而减少磁盘占用
- 你有多个不同的类型的 GUI 程序,如:WebUI, 你想要他们共用模型文件
- 模型文件无法被识别或读取到
extra_model_paths.yaml
配置文件来添加额外模型搜索路径的方法。
不同 ComfyUI 版本配置文件位置
配置示例
比如,你需要额外让 ComfyUI 识别的模型文件位于下面的文件夹:对于桌面版,请在原有配置路径下新增配置,而不覆盖掉安装过程中自动生成的路径配置,请在修改前备份对应的文件,这样在你配置错误时可以及时恢复
添加额外自定义节点路径
除了添加外部模型之外,你同样可以添加不在 ComfyUI 默认路径下的自定义节点路径请注意,这并不会改变自定义节点的默认安装路径,只是在启动 ComfyUI 时会增加额外的路径搜索,你仍旧需要在对应的环境中完成自定义节点的依赖的安装,来保证其运行环境的完整性。
桌面端 Python 环境相关
桌面端的安装将在你选择的安装目录下创建一个python 的虚拟环境,通常这是一个隐藏的.venv
文件夹。
如果你需要为 ComfyUI 插件处理相关的依赖则需要在这个环境中进行处理,直接系统系统的命令行会有将对应依赖安装到系统环境的风险,请参考下面的指示完成对应环境的激活。
如何使用 桌面端 的 python 环境?
你可以使用桌面端自带的终端来使用 python 环境。

- 点击菜单栏的 icon 打开底部面板
- 点击
Terminal
打开终端 - 如果你想要看对应环境的 python 安装位置,可以使用下面的命令
除非你了解你当前的操作含义,否则你的操作可能会导致对应环境依赖的问题,请谨慎使用此方式进行操作
如何卸载 ComfyUI 桌面版
对于 ComfyUI 桌面版 你可以在 Windows 的系统设置中使用系统的卸载功能来完成对应软件的卸载操作
- C:\Users<你的用户名>\AppData\Local@comfyorgcomfyui-electron-updater
- C:\Users<你的用户名>\AppData\Local\Programs@comfyorgcomfyui-electron
- C:\Users<你的用户名>\AppData\Roaming\ComfyUI
- models 模型文件
- custom nodes 自定义节点
- input/output directories. 图片输入/输出目录
故障排除
显示不支持的设备

- 请更换使用支持的设备
- 或者考虑使用 ComfyUI便携版 或者通过手动安装来使用 ComfyUI
如何定位安装错误
如果安装失败,你应该可以看到下面的界面显示
- 点击
Show Teriminal
查看错误问题输出 - 点击
Open Logs
查看安装过程日志 - 访问官方论坛查找错误反馈
- 点击
Reinstall
尝试重新安装


反馈错误
如果在安装过程中,你发生了任何错误,请通过以下任意方式查看是否有类似错误反馈,或者向我们提交错误- Github Issues: https://github.com/Comfy-Org/desktop/issues
- Comfy 官方论坛: https://forum.comfy.org/
- 日志文件
文件名 | 描述 | 位置 |
---|---|---|
main.log | 包含与桌面应用和服务器启动相关的日志,来自桌面的 Electron 进程。 | |
comfyui.log | 包含与 ComfyUI 正常运行相关的日志,例如核心 ComfyUI 进程的终端输出。 |

- 配置文件
文件名 | 描述 | 位置 |
---|---|---|
extra_model_paths.yaml | 包含 ComfyUI 将搜索模型和自定义节点的额外路径。 | |
config.json | 包含应用配置。此文件通常不应直接编辑。 |
