【本地玩AI】在macOS+AppleSilicon安装ComfyUI

优质文章学习记录

06 Apr 2026 — 8 min read

原文：https://atlassc.net/2025/01/15/installing-comfyui-on-macos-with-apple-silicon

一、前置条件：

1、芯片：确保芯片是Apple Silicon，比如 M1，M2，M3，M4；

2、macOS版本：确保mac系统版本 12.3+；

3、Xcode Command Line Tools：如果没有安装运行如下命令行：

$ xcode-select --install

4、Python：确保版本 3.7+，推荐3.10，后续使用conda来安装对应版本；

接下来是安装ComfyUI，可以通过手动安装，也可以直接安装 Comfy UI Desktop（桌面版）。

二、手动安装

2.1、安装PyTorch

ComfyUI使用PyTorch来优化性能

2.1.1 安装 Ananconda

$ curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh sh 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

这里注意一定激活comfyiu环境，这样后续的操作才会约束在此环境中。

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会被启动：

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

恭喜你，安装成功！

三、安装 ComfyUI Desktop桌面版

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

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

3.1、下载

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

下载后安装：

3.2、GPU配置

安装后运行 ComfyUI：

点击开始，选择安装方式：

注意这个界面，有三个选项：

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设置

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。

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

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

四、插件安装配置

4.1、ComfyUI Manager

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

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

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

$ cd 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两个节点可以编辑和绘画姿态，实现所画即所得。

4.4、ComfyUI-Custom-Scripts

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

4.5、ComfyUI-Advanced-ControlNet

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

4.6、ComfyUI_IPAdapter_plus

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

4.7、comfyui_controlnet_aux

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

插件 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	运行日志