跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

在 macOS 与 Apple Silicon 上安装 ComfyUI

介绍在 macOS 系统配合 Apple Silicon 芯片环境下部署 ComfyUI 的两种方法:手动安装(基于 Conda 和 PyTorch)及桌面版安装。内容涵盖前置条件检查、依赖配置、插件管理(如 Manager、汉化、ControlNet)及相关路径设置,旨在帮助用户快速搭建本地 AI 绘图工作流。

晚风告白发布于 2026/4/6更新于 2026/10/25131 浏览
在 macOS 与 Apple Silicon 上安装 ComfyUI

一、前置条件

  1. 芯片:确保芯片是 Apple Silicon,如 M1、M2、M3、M4;
  2. macOS 版本:确保系统版本为 12.3+;
  3. Xcode Command Line Tools:如果没有安装,运行以下命令:
xcode-select --install
  1. Python:确保版本 3.7+,推荐 3.10,后续使用 conda 来安装对应版本。

接下来是安装 ComfyUI,可以通过手动安装,也可以直接安装 Comfy UI Desktop(桌面版)。

二、手动安装

2.1、安装 PyTorch

ComfyUI 使用 PyTorch 来优化性能。

2.1.1 安装 Anaconda
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh && bash Miniconda3-latest-MacOSX-arm64.sh
2.1.2 创建 Conda 环境
# 创建 conda 环境 comfyui,使用 python 3.12.11
conda create -n comfyui python=3.12.11
# 激活 conda 环境 comfyui
conda activate comfyui

注意:一定激活 comfyui 环境,这样后续的操作才会约束在此环境中。

2.1.3 安装 PyTorch
conda install pytorch torchvision torchaudio -c pytorch-nightly
2.2、安装 ComfyUI

拉取代码:

git clone https://github.com/comfyanonymous/ComfyUI.git

安装依赖:

cd ComfyUI
pip install -r requirements.txt

如果安装过程报错,例如以下报错:

ERROR: Could not find a version that satisfies the requirement comfy-kitchen>=0.2.5 (from versions: none) ERROR: No matching distribution found for comfy-kitchen>=0.2.5

表示源中并没有此依赖。确认下确实没有,原因是使用了清华的源。那么先从官方源安装此组件,然后再安装:

pip install -i https://pypi.org/simple --no-cache-dir comfy-kitchen
2.3、运行 ComfyUI

通过 python 来运行:

python main.py

ComfyUI server 会被启动:

[图片:ComfyUI 启动界面]

此时可以通过浏览器访问 http://127.0.0.1:8188 来访问:

[图片:ComfyUI 网页界面]

恭喜你,安装成功!

三、安装 ComfyUI Desktop 桌面版

桌面版会自动配置 Python 环境和依赖,并支持导入已有的 ComfyUI 设置、模型、工作流和文件。

ComfyUI 桌面版(macOS)目前仅支持 Apple Silicon。

3.1、下载

下载地址:https://download.comfy.org/mac/dmg/arm64

下载后安装:

[图片:DMG 安装界面]

3.2、GPU 配置

安装后运行 ComfyUI:

[图片:ComfyUI 启动弹窗]

点击开始,选择安装方式:

[图片:GPU 配置选项]

注意这个界面,有三个选项:

  • Apple Metal:推荐,只有这个选项才会自动安装 PyTorch 官方给 Apple Silicon 准备的 MPS 后端,也就是调用 GPU 的加速能力;
  • CPU Mode:只使用 CPU 的能力,放弃;
  • Manual Configuration:手动安装配置;
3.3、配置安装路径

这是用户的配置信息(模型等)存放的路径。

[图片:路径配置界面]

这里的路径是 ComfyUI 的数据存放路径,包含模型文件、用户配置、输入输出等:

[图片:数据目录结构]

[图片:配置文件位置]

这里三个镜像源的设置,注意后面如果是绿色的钩,表示镜像源正常,否则连接有问题,更换为正常的源即可:

Python Mirror: https://python-standalone.org/mirror/astral-sh/python-build-standalone

Pypi Mirror:

  • Alibaba Cloud: https://mirrors.aliyun.com/pypi/simple/
  • Tencent Cloud: https://mirrors.cloud.tencent.com/pypi/simple/
  • University of Science and Technology of China: https://pypi.mirrors.ustc.edu.cn/simple/
  • Shanghai Jiao Tong University: https://pypi.sjtu.edu.cn/simple/
  • TsingHua University: https://pypi.tuna.tsinghua.edu.cn/simple

Torch Mirror: https://download.pytorch.org/whl/nightly/cpu

3.4、App 设置

[图片:App 设置界面]

3.5、等待配置完成

[图片:配置进度界面]

[图片:配置完成界面]

这个过程会耗费一些时间,安装完成后进入主界面:

[图片:主界面]

到此,ComfyUI Desktop 桌面版安装完成。

3.6、桌面版的一些问题

3.6.1 启动时报错:

Failed to initialize database. Please ensure you have installed the latest requirements. If the error persists, please report this as in future the database will be required: (sqlite3.OperationalError) unable to open database file (Background on this error at: https://sqlalche.me/e/20/e3q8)

这个目前无解(版本 0.7.2),提示不影响运行。如果不想看到这个提示,可以在 /Application/ComfyUI/Contents/Resources/ComfyUI 下新建 user 目录,然后重新启动,会在新建的 user 目录下生成一个空的 comfyui.db。

[图片:User 目录创建]

3.6.2 资产不显示以前生成的图

应该也是跟 #3.6.1 有关系,现在官方并没有解决。可以找一个手动安装版本的看一下 comfyui.db 中大概包含的数据:

[图片:数据库内容示例 1]

[图片:数据库内容示例 2]

[图片:数据库内容示例 3]

[图片:数据库内容示例 4]

[图片:数据库内容示例 5]

[图片:数据库内容示例 6]

[图片:数据库内容示例 7]

[图片:数据库内容示例 8]

四、插件安装配置

4.1、ComfyUI Manager

新版 0.7.0 已经内置此插件,旧版本可以按照下面方式安装。

ComfyUI manager 是一个用来加强 ComfyUI 可用性的扩展,提供了对 ComfyUI 各种自定义节点的安装、删除、禁用、启用等管理功能。同时还提供了中心功能和便利功能,用来访问 ComfyUI 中各种信息。

转到 ComfyUI 的用户配置路径(参考 3.3)下的 custom_nodes:

cd custom_nodes/

[图片:Custom Nodes 目录]

这里的 ComfyUIDesktop 是在 #3.3 中配置的安装路径。

使用 git 拉取 ComfyUI Manager:

git clone https://github.com/ltdrdata/ComfyUI-Manager.git

安装完后重启 ComfyUI。

4.2、汉化插件安装

ComfyUI Manager 安装好之后,就可以通过 ComfyUI Manager 来直接安装汉化插件,不然需要手动下载汉化包到 custom_nodes 目录下。

打开 ComfyUI Manager,搜索框中输入 translation,安装第一个即可(后续插件同样步骤进行安装)。

[图片:翻译插件搜索]

安装好之后要重启 ComfyUI,然后点击设置,在翻译语言栏选择中文即可。

4.3、ComfyUI_Custom_Nodes_AlekPet

提供了提示词的翻译功能。有了这个插件,再也不用使用第三方翻译软件翻译提示词后,再粘贴到 CLIP 文本编码器中了。

同时提供的 PoseNode、PainterNode 两个节点可以编辑和绘画姿态,实现所画即所得。

[图片:AlekPet 插件功能]

4.4、ComfyUI-Custom-Scripts

给模型分类,更加便捷的调用模型 针对输入自动补齐,信息的索引 更丰富的功能设定页面

[图片:Custom Scripts 界面]

4.5、ComfyUI-Advanced-ControlNet

ControlNet 插件,使用线稿、姿态、深度、IP 等控制数据和响应的 ControlNet 模型控制图片的生成,Stable Diffusion 必备。

[图片:Advanced ControlNet 界面]

4.6、ComfyUI_IPAdapter_plus

用于图像到图像调节的非常强大的模型。图像的主题甚至风格都可以迁移到所生成的图像中。 地址:https://github.com/cubiq/ComfyUI_IPAdapter_plus

[图片:IPAdapter 界面]

4.7、comfyui_controlnet_aux

ControlNet 的预处理器,用于从参考图片中提取线稿、姿态、深度、IP 等控制数据。

[图片:ControlNet Aux 界面]

插件 comfyui_controlnet_aux 安装有异常:

Full error log from comfyui_controlnet_aux: Traceback (most recent call last): ... ... import matplotlib ModuleNotFoundError: No module named 'matplotlib'

解决方案是手动安装 matplotlib。

这里注意要在 venv 环境中执行。

1、如果是手动安装,先 $ conda activate comfyui 激活环境,然后执行上面安装:

2、如果是安装的桌面版,在桌面版的命令行中执行:

五、相关配置

名称配置说明
配置目录#3.3 配置,如:/Users/yong/dev/ai/ComfyUI.Data存放模型文件,存放用户配置
缓存工作/Users/yong/Library/Application Support/ComfyUI缓存配置
日志/Users/yong/Library/Logs/ComfyUI运行日志

目录

  1. 一、前置条件
  2. 二、手动安装
  3. 2.1、安装 PyTorch
  4. 2.1.1 安装 Anaconda
  5. 2.1.2 创建 Conda 环境
  6. 创建 conda 环境 comfyui,使用 python 3.12.11
  7. 激活 conda 环境 comfyui
  8. 2.1.3 安装 PyTorch
  9. 2.2、安装 ComfyUI
  10. 2.3、运行 ComfyUI
  11. 三、安装 ComfyUI Desktop 桌面版
  12. 3.1、下载
  13. 3.2、GPU 配置
  14. 3.3、配置安装路径
  15. 3.4、App 设置
  16. 3.5、等待配置完成
  17. 3.6、桌面版的一些问题
  18. 四、插件安装配置
  19. 4.1、ComfyUI Manager
  20. 4.2、汉化插件安装
  21. 4.3、ComfyUICustomNodes_AlekPet
  22. 4.4、ComfyUI-Custom-Scripts
  23. 4.5、ComfyUI-Advanced-ControlNet
  24. 4.6、ComfyUIIPAdapterplus
  25. 4.7、comfyuicontrolnetaux
  26. 五、相关配置

更多推荐文章

查看全部
  • Flutter 三方库 web_ffi 的鸿蒙化适配指南
  • GitHub Copilot 学生认证申请流程与常见问题解答
  • 基于阿里开源 CoPaw 在魔搭创空间搭建个人 AI 助理
  • AI 原生 IDE 深度对比:Cursor、Trae 与 Windsurf 选型指南
  • C++ 类与对象核心概念入门
  • Go 高并发微服务调优:Goroutine、Channel、Context 核心实践
  • OpenClaw 结合本地 Ollama 搭建个人 AI 助手实战
  • 使用 ChatGPT 降低毕业论文 AIGC 检测率的策略
  • GLM-4.6V-Flash-WEB 图像问答适用场景详解
  • 硕士论文盲审前降低 AIGC 检测率策略与评委关注点解析
  • 金仓数据库 Oracle 与 SQL Server 迁移兼容性对比及实操指南
  • Ubuntu 22.04 下 libwebkit2gtk-4.1-0 安装与避坑指南
  • Maven 基础入门:在 IntelliJ IDEA 中创建与配置项目
  • AI Agent 产业链深度解析与核心架构分析
  • 前缀和算法实战:区间乘积与整除子数组
  • 本地离线部署 Whisper 模型进行语音转写
  • 星露谷农场规划器技术架构:Node.js 后端与 SVG 前端渲染实现
  • Faster-Whisper 本地实时语音识别部署指南
  • 包装类与泛型的那些坑:从自动装箱到类型擦除
  • Python 布尔类型(bool)核心用法与特性

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online