ComfyUI 桌面版（Desktop） 是一个独立的安装版本，可以像常规软件一样安装，支持快捷安装自动配置 Python环境及依赖 ，支持导入已有的 ComfyUI 设置、模型、工作流和文件

ComfyUI 桌面版是一个开源项目，完整代码请访问 这里

ComfyUI 桌面版（MacOS） 目前仅支持 Apple Silicon

本篇教程将引导你完成对应的软件安装，并说明相关安装配置说明。

由于 ComfyUI 桌面版 仍旧处于 Beta 状态，实际的安装过程可能会发生变化

​
ComfyUI 桌面版（MacOS）下载

请点击下面的按钮下载对应的针对 MacOS 系统的 ComfyUI 桌面版 安装包

Download for MacOS

​
ComfyUI 桌面版安装步骤

双击下载到的安装包文件，如图所示，请将ComfyUI程序，按键头所示拖入Applications文件夹

如果打开安装包后你的文件夹显示如下，在图标上出现禁止符号，说明你当前的系统版本与当前 ComfyUI 桌面版并不兼容

然后在 启动台(Lanchpad) 找到对应的 ComfyUI 图标 点击将进入 ComfyUI 的初始化设置

​
ComfyUI 桌面版初始化流程

1

开始界面

点击 Get Started 开始初始化步骤

2

Select GPU(GPU选择)

对应三个选项为：

  1. MPS（推荐）: Metal Performance Shaders (MPS) 是苹果的优化框架，让开发者能在苹果设备上利用 GPU 加速包括机器学习在内的高性能计算任务，且支持 PyTorch 等框架使用 GPU 提升模型训练和推理效率。
  2. Manual Configuration 手动配置: 你需要手动安装和配置 python 运行环境，除非你知道应该如何配置，否则请不要选择
  3. Enable CPU Mode 启用 CPU 模式: 仅适用于开发人员和特殊情况，除非你确定你需要使用这个模式，否则请不要选择

如无特殊情况，请按截图所示选择 MPS，并点击 Next 进入下一步

3

Install location（安装位置）

在这一步将选择 ComfyUI 以下相关内容的安装位置：

  • Python 环境
  • Models 模型文件
  • Custom Nodes 自定义节点 建议：
  • 请新建一个单独的空白文件夹作为 ComfyUI 的安装目录
  • 请保证磁盘至少有 5G 左右的磁盘空间，以保证 ComfyUI桌面版 的正常安装

ComfyUI 并非所有文件都安装在此目录下，部分文件将会位于 MacOS 的系统目录下，你可以参考本篇指南的卸载部分完成完整的 ComfyUI 桌面版的卸载
完成后点击 Next 进入下一步

4

Migrate from Existing Installation（从已有安装迁移 - 可选）

在这一步你可以将你已有的 ComfyUI 安装内容迁移到 ComfyUI 桌面版中，选择你电脑上已有的 ComfyUI 安装目录，安装程序会自动识别对应目录下的：

  • User Files 用户文件
  • Models 模型文件: 不会进行复制，只是与桌面版进行关联
  • Custom Nodes 自定义节点: 节点将会重新进行安装

不要担心，这个步骤并不会复制模型文件，你可以按你的需要勾选或者取消勾选对应的选项，点击 Next 进入下一步

5

Desktop Setting(桌面版设置)

这一步是偏好设置

  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

PyPI 镜像

Torch 镜像

6

完成安装

如果一切无误，安装程序将完成安装并自动进入 ComfyUI 桌面版界面, 则说明已经安装成功

​
进行第一次图片生成

安装成功后，你可以参考访问下面的章节，开始你的 ComfyUI 之路。

进行第一次图片生成

本教程将引导你完成第一次的模型安装以及对应的文本到图片的生成

​
如何更新 ComfyUI 桌面版

目前 ComfyUI 桌面版更新采用自动检测更新，请确保在设置中已经启用自动更新

​
如何卸载 ComfyUI 桌面版

对于 ComfyUI 桌面版 的卸载你可以直接在 Application 文件夹内删除 ComfyUI

如果你想要完全删除 ComfyUI 桌面版 的所有文件，你可以手动删除以下文件夹：

  • /Users/Library/Application Support/ComfyUI

以上的操作并不会删除以下你的以下文件夹，如果你需要删除对应文件的话，请手动删除：

  • models 模型文件
  • custom nodes 自定义节点
  • input/output directories. 图片输入/输出目录

​
故障排除

​
如何定位安装错误

如果安装失败，你应该可以看到下面的界面显示

此时建议你采取以下几种方式查找错误原因

  1. 点击 Show Teriminal 查看错误问题输出
  2. 点击 Open Logs 查看安装过程日志
  3. 访问官方论坛查找错误反馈
  4. 点击Reinstall尝试重新安装

建议在提交反馈之前，你可以将对应的错误输出以及 log 文件信息提供给类似 GPT一类的工具

如上图，询问对应错误的原因，或者完全删除 ComfyUI 后进行安装重试

​
反馈错误

如果在安装过程中，你发生了任何错误，请通过以下任意方式查看是否有类似错误反馈，或者向我们提交错误

请在提交错误时确保提交了以下日志以及配置文件，方便我们进行问题的定位和查找

  1. 日志文件
文件名描述位置
main.log包含与桌面应用和服务器启动相关的日志，来自桌面的 Electron 进程。
comfyui.log包含与 ComfyUI 正常运行相关的日志，例如核心 ComfyUI 进程的终端输出。

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

此页面对您有帮助吗？

建议编辑
Windows桌面版Linux桌面版