本文将介绍 ComfyUI Desktop Windows 版本的下载以及安装使用
ComfyUI 桌面版(Desktop) 是一个独立的安装版本,可以像常规软件一样进行安装,支持快捷安装自动配置 Python环境及依赖 ,支持导入已有的 ComfyUI 设置、模型、工作流和文件,可以快速从已有的ComfyUI 便携版迁移到桌面版
ComfyUI 桌面版是一个开源项目,完整代码请访问 这里
ComfyUI 桌面版(Windows)硬件要求:
本篇教程将引导你完成对应的软件安装,并说明相关安装配置说明。
请点击下面的按钮下载对应的针对 Windows 系统的 ComfyUI 桌面版 安装包
Download for Windows (NVIDIA)
双击下载到的安装包文件,首先将会执行一次自动安装,并在桌面生成一个 ComfyUI 桌面版 的快捷方式
双击对应的快捷,进入 ComfyUI 的初始化设置
开始界面
点击 Get Started 开始初始化步骤
点击 Get Started 开始初始化步骤
安装 ComfyUI 可能会出现许多问题。也许在安装 pytorch(15 GB)时网络连接失败,或者你没有安装 git,当检测到问题时,维护页面会自动打开,并提供解决问题的方法。
你可以使用它来解决大多数问题:
默认维护页面会显示当前报错的内容
点击 All
可以切换查看可以操作的所有内容
Select GPU(GPU选择)
对应三个选项为:
如无特殊情况,请按截图所示选择NVIDIA,并点击 Next 进入下一步
Install location(安装位置)
在这一步将选择 ComfyUI 以下内容的安装位置:
建议:
完成后点击 Next 进入下一步
Migrate from Existing Installation(从已有安装迁移 - 可选)
在这一步你可以将你已有的 ComfyUI 安装内容迁移到 ComfyUI 桌面版中,如图所示,选择了原本的 D:\ComfyUI_windows_portable\ComfyUI 安装目录,安装程序会自动识别对应目录下的:
不要担心,这个步骤并不会复制模型文件,你可以按你的需要勾选或者取消勾选对应的选项,点击 Next 进入下一步
Desktop Setting(桌面版设置)
这一步是偏好设置
展开对应的镜像设置,找到具体失败的镜像,在当前截图中错误为 Python Install Mirror 镜像失败。
对于不同的镜像错误,你可以参考下面的内容尝试手动查找不同的镜像,并进行替换
以下情况主要针对中国境内用户
如果默认镜像无法使用,请尝试使用下面的镜像
如果你需要查找其它备选 GitHub 的镜像地址,请查找并构建指向 python-build-standalone
仓库releases的镜像地址
构建类似下面格式的链接
完成安装
如果一切无误,安装程序将完成安装并自动进入 ComfyUI 桌面版界面, 则说明已经安装成功
安装成功后,你可以参考访问下面的章节,开始你的 ComfyUI 之路。
本教程将引导你完成第一次的模型安装以及对应的文本到图片的生成
目前 ComfyUI 桌面版更新采用自动检测更新,请确保在设置中已经启用自动更新
你也可以在 菜单
—> 帮助
—> 检查更新
中选择手动检查是否有可用的更新
如果你在计算机上的 ComfyUI 安装目录之外的其他位置存储了模型,可以通过配置 extra_model_paths.yaml
文件将它们添加到 ComfyUI 中。
对于 ComfyUI 桌面版,此文件位于:
C:\Users\<你的用户名>\AppData\Roaming\ComfyUI\extra_model_paths.yaml
~/Library/Application Support/ComfyUI/extra_model_paths.yaml
~/.config/ComfyUI/extra_model_paths.yaml
详细说明请参见模型文档
桌面端的安装将在你选择的安装目录下创建一个python 的虚拟环境,通常这是一个隐藏的 .venv
文件夹。
如果你需要为 ComfyUI 插件处理相关的依赖则需要在这个环境中进行处理,直接系统系统的命令行会有将对应依赖安装到系统环境的风险,请参考下面的指示完成对应环境的激活。
你可以使用桌面端自带的终端来使用 python 环境。
Terminal
打开终端which python
查看当前 python 所在的安装环境然后你就可以在这里进行依赖安装相关的操作了。
你可以使用桌面端自带的终端来使用 python 环境。
Terminal
打开终端which python
查看当前 python 所在的安装环境然后你就可以在这里进行依赖安装相关的操作了。
你也可以使用你喜欢的终端来使用 python 环境,但在使用之前需要先激活对应的虚拟环境。
在使用其它终端进行操作时,如果你不熟悉相关操作,可能会将对应依赖安装到系统环境,请谨慎使用次方式进行操作
在截图中,是一个 macOS 终端的示例。如果你使用的是 Windows,请参考以下步骤在系统上激活虚拟环境。
打开终端
打开你喜欢的终端,使用 cd
命令进入你安装的 ComfyUI 的目录如
激活虚拟环境
在终端中输入下面的命令激活虚拟环境
激活后,你可以在终端中看到类似 (ComfyUI)
的提示,表示你已经激活了虚拟环境
确认当前 python 环境
使用 which python
查看当前 python 所在环境,确认不是系统环境
对于 ComfyUI 桌面版 你可以在 Windows 的系统设置中使用系统的卸载功能来完成对应软件的卸载操作
如果你想要完全删除 ComfyUI 桌面版 的所有文件,你可以手动删除以下文件夹:
以上的操作并不会删除以下你的以下文件夹,如果你需要删除对应文件的话,请手动删除:
由于 ComfyUI 桌面版(Windows)仅支持可以使用 CUDA 的 Nvdia 显卡 所以如果你的设备不支持,可能会出现此界面
如果安装失败,你应该可以看到下面的界面显示
此时建议你采取以下几种方式查找错误原因
Show Teriminal
查看错误问题输出Open Logs
查看安装过程日志Reinstall
尝试重新安装建议在提交反馈之前,你可以将对应的错误输出以及 log 文件信息提供给类似 GPT一类的工具
如上图,询问对应错误的原因,或者完全删除 ComfyUI 后进行安装重试
如果在安装过程中,你发生了任何错误,请通过以下任意方式查看是否有类似错误反馈,或者向我们提交错误
请在提交错误时确保提交了以下日志以及配置文件,方便我们进行问题的定位和查找
文件名 | 描述 | 位置 |
---|---|---|
main.log | 包含与桌面应用和服务器启动相关的日志,来自桌面的 Electron 进程。 | |
comfyui.log | 包含与 ComfyUI 正常运行相关的日志,例如核心 ComfyUI 进程的终端输出。 |
文件名 | 描述 | 位置 |
---|---|---|
extra_model_paths.yaml | 包含 ComfyUI 将搜索模型和自定义节点的额外路径。 | |
config.json | 包含应用配置。此文件通常不应直接编辑。 |