> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-train-lora-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Windows桌面版
> 本文将介绍 ComfyUI Desktop Windows 版本的下载以及安装使用
export const log_path_0 = "C:\Users\ <你的用户名> \AppData\Roaming\ComfyUI\logs"
export const config_path_0 = "C:\Users\ <你的用户名> \AppData\Roaming\ComfyUI"
**ComfyUI 桌面版（Desktop）** 是一个独立的安装版本，可以像常规软件一样进行安装，支持快捷安装自动配置 **Python环境及依赖** ，支持导入已有的 ComfyUI 设置、模型、工作流和文件，可以快速从已有的[ComfyUI 便携版](/zh-CN/installation/comfyui_portable_windows)迁移到桌面版
ComfyUI 桌面版是一个开源项目，完整代码请访问 [这里](https://github.com/Comfy-Org/desktop)
ComfyUI 桌面版(Windows)硬件要求：
* NVIDIA 显卡
本篇教程将引导你完成对应的软件安装，并说明相关安装配置说明。
由于 **ComfyUI 桌面版** 仍旧处于 **Beta** 状态，实际的安装过程可能会发生变化
## ComfyUI 桌面版（Windows）下载
请点击下面的按钮下载对应的针对 Windows 系统的 **ComfyUI 桌面版** 安装包
Download for Windows (NVIDIA)
## ComfyUI 桌面版安装步骤
双击下载到的安装包文件，首先将会执行一次自动安装，并在桌面生成一个 **ComfyUI 桌面版** 的快捷方式
双击对应的快捷，进入 ComfyUI 的初始化设置
### ComfyUI 桌面版初始化流程
点击 **Get Started** 开始初始化步骤
安装 ComfyUI 可能会出现许多问题。也许在安装 pytorch（15 GB）时网络连接失败，或者你没有安装 git，当检测到问题时，维护页面会自动打开，并提供解决问题的方法。
你可以使用它来解决大多数问题：
* 创建一个 Python 虚拟环境
* 重新安装所有缺失的核心依赖项到由桌面管理的 Python 虦虚拟环境
* 安装 git，VC redis
* 选择一个新的安装位置
默认维护页面会显示当前报错的内容
点击 `All` 可以切换查看可以操作的所有内容
对应三个选项为：
1. **Nvidia 显卡（推荐）:** 直接支持使用 pytorch 和 CUDA
2. **Manual Configuration 手动配置:** 你需要手动安装和配置 python 运行环境，除非你知道应该如何配置，否则请不要选择
3. **Enable CPU Mode 启用 CPU 模式:** 仅适用于开发人员和特殊情况，除非你确定你需要使用这个模式，否则请不要选择
如无特殊情况，请按截图所示选择**NVIDIA**，并点击 **Next** 进入下一步
在这一步将选择 ComfyUI 以下内容的安装位置：
* **Python 环境**
* **Models 模型文件**
* **Custom Nodes 自定义节点**
建议：
* 请选择**固态硬盘**作为安装位置，这将提高 ComfyUI 访问模型的速度。
* 请新建一个单独的空白文件夹作为 ComfyUI 的安装目录
* 请保证对应磁盘至少有 **15G** 左右的磁盘空间，以保证 ComfyUI Desktop 的安装
ComfyUI 并非所有文件都安装在此目录下，部分文件依然会安装在 C 盘，后期如需卸载，你可以参考本篇指南的卸载部分完成完整的 ComfyUI 桌面版的卸载
完成后点击 **Next** 进入下一步
在这一步你可以将你已有的 ComfyUI 安装内容迁移到 ComfyUI 桌面版中，如图所示，选择了原本的 **D:\ComfyUI\_windows\_portable\ComfyUI** 安装目录，安装程序会自动识别对应目录下的：
* **User Files 用户文件**
* **Models 模型文件:** 不会进行复制，只是与桌面版进行关联
* **Custom Nodes 自定义节点:** 自定义节点将会重新进行安装
不要担心，这个步骤并不会复制模型文件，你可以按你的需要勾选或者取消勾选对应的选项，点击 **Next** 进入下一步
这一步是偏好设置
1. **Automatic Updates 自动更新:** 是否设置在 ComfyUI 更新可用时自动更新
2. **Usage Metrics 使用情况分析:** 如果启用，我们将收集**匿名的使用数据** 用于帮助我们改进 ComfyUI
3. **Mirror Settings 镜像设置:** 由于程序需要联网下载 Python 完成相关环境安装，如果你在安装时候也如图所示出现了红色的❌，提示这可能会导致后续安装过程的失败，则请参考下面步骤进行处理
展开对应的镜像设置，找到具体失败的镜像，在当前截图中错误为 **Python Install Mirror** 镜像失败。
对于不同的镜像错误，你可以参考下面的内容尝试手动查找不同的镜像，并进行替换
以下情况主要针对中国境内用户
#### Python 安装镜像
如果默认镜像无法使用，请尝试使用下面的镜像
```
https://python-standalone.org/mirror/astral-sh/python-build-standalone
```
如果你需要查找其它备选 GitHub 的镜像地址，请查找并构建指向 `python-build-standalone` 仓库releases的镜像地址
```
https://github.com/astral-sh/python-build-standalone/releases/download
```
构建类似下面格式的链接
```
https://xxx/astral-sh/python-build-standalone/releases/download
```
由于大多 Github 镜像服务都由第三方提供，所以请注意使用过程中的安全性。
#### PyPI 镜像
* 阿里云：[https://mirrors.aliyun.com/pypi/simple/](https://mirrors.aliyun.com/pypi/simple/)
* 腾讯云：[https://mirrors.cloud.tencent.com/pypi/simple/](https://mirrors.cloud.tencent.com/pypi/simple/)
* 中国科技大学：[https://pypi.mirrors.ustc.edu.cn/simple/](https://pypi.mirrors.ustc.edu.cn/simple/)
* 上海交通大学：[https://pypi.sjtu.edu.cn/simple/](https://pypi.sjtu.edu.cn/simple/)
#### Torch 镜像
* 阿里云: [https://mirrors.aliyun.com/pytorch-wheels/cu121/](https://mirrors.aliyun.com/pytorch-wheels/cu121/)
如果一切无误，安装程序将完成安装并自动进入 ComfyUI 桌面版界面, 则说明已经安装成功
## 进行第一次图片生成
安装成功后，你可以参考访问下面的章节，开始你的 ComfyUI 之路。
本教程将引导你完成第一次的模型安装以及对应的文本到图片的生成
## 如何更新 ComfyUI 桌面版
目前 ComfyUI 桌面版更新采用自动检测更新，请确保在设置中已经启用自动更新
你也可以在 `菜单` --> `帮助` --> `检查更新` 中选择手动检查是否有可用的更新
## 添加外部模型路径
如果你在计算机上的 ComfyUI 安装目录之外的其他位置存储了模型，可以通过配置 `extra_model_paths.yaml` 文件将它们添加到 ComfyUI 中。
对于 ComfyUI 桌面版，此文件位于：
* Windows：`C:\Users\<你的用户名>\AppData\Roaming\ComfyUI\extra_model_paths.yaml`
* macOS：`~/Library/Application Support/ComfyUI/extra_model_paths.yaml`
* Linux：`~/.config/ComfyUI/extra_model_paths.yaml`
详细说明请参见[模型文档](/zh-CN/development/core-concepts/models#adding-external-model-paths)
## 如何卸载 ComfyUI 桌面版
对于 **ComfyUI 桌面版** 你可以在 Windows 的系统设置中使用系统的卸载功能来完成对应软件的卸载操作
如果你想要完全删除 **ComfyUI 桌面版** 的所有文件，你可以手动删除以下文件夹：
* 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 桌面版（Windows）仅支持可以使用 **CUDA 的 Nvdia 显卡** 所以如果你的设备不支持，可能会出现此界面
* 请更换使用支持的设备
* 或者考虑使用 [ComfyUI便携版](/zh-CN/installation/comfyui_portable_windows) 或者通过[手动安装](/zh-CN/installation/manual_install)来使用 ComfyUI
### 如何定位安装错误
如果安装失败，你应该可以看到下面的界面显示
此时建议你采取以下几种方式查找错误原因
1. 点击 `Show Teriminal` 查看错误问题输出
2. 点击 `Open Logs` 查看安装过程日志
3. 访问官方论坛查找错误反馈
4. 点击`Reinstall`尝试重新安装
建议在提交反馈之前，你可以将对应的**错误输出**以及 **log 文件**信息提供给类似 **GPT**一类的工具
如上图，询问对应错误的原因，或者完全删除 ComfyUI 后进行安装重试
### 反馈错误
如果在安装过程中，你发生了任何错误，请通过以下任意方式查看是否有类似错误反馈，或者向我们提交错误
* Github Issues: [https://github.com/Comfy-Org/desktop/issues](https://github.com/Comfy-Org/desktop/issues)
* Comfy 官方论坛: [https://forum.comfy.org/](https://forum.comfy.org/)
请在提交错误时确保提交了以下日志以及配置文件，方便我们进行问题的定位和查找
1. 日志文件
| 文件名 | 描述 | 位置 |
| ----------- | ------------------------------------------- | ------------ |
| main.log | 包含与桌面应用和服务器启动相关的日志，来自桌面的 Electron 进程。 | {log_path_0} |
| comfyui.log | 包含与 ComfyUI 正常运行相关的日志，例如核心 ComfyUI 进程的终端输出。 | {log_path_0} |
2. 配置文件
| 文件名 | 描述 | 位置 |
| ------------------------ | ---------------------------- | --------------- |
| extra\_model\_paths.yaml | 包含 ComfyUI 将搜索模型和自定义节点的额外路径。 | {config_path_0} |
| config.json | 包含应用配置。此文件通常不应直接编辑。 | {config_path_0} |
