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

在 macOS 与 Apple Silicon 上安装 ComfyUI

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

晚风告白发布于 2026/4/6更新于 2026/6/536 浏览
在 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. 五、相关配置
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Gemini Pro 实测:多模态、推理与代码能力的真实表现
  • AI 时代技术民主化:文科生的新机遇与核心优势
  • Altera FPGA Avalon 总线接口规范简介
  • 前端国际化实现方案
  • OpenClaw AI 智能体安装配置与使用指南
  • Web 前端基础:HTML 核心语法与常用标签
  • 大模型、AI 大模型与 GPT 模型详解
  • 程序员日常:我以为的工作量 VS 实际上的工作量
  • AIGC 中的变分自编码器(VAE)代码与实现
  • 深入理解 JSON Web Token (JWT) 原理与安全实践
  • 前端数据埋点:核心原理、主流方案与落地实践
  • Django REST Framework 重构智能合同审查系统实战
  • 使用 FastAPI 和 HTML/CSS/JavaScript 构建博客系统示例
  • JetBrains IDE 插件 Continue 安装配置指南
  • Ubuntu 24.04 Server 系统安装及配置指南
  • 深度对比 vLLM、SGLang 与 llama.cpp 推理引擎
  • Min-Max 归一化算法实例解析
  • Z-Image-Turbo 镜像构建技术细节剖析
  • OpenClaw 全平台卸载指南:Windows、macOS、Linux 及包管理器清理
  • GitHub 启用双因素身份验证(2FA)配置指南:TOTP.app 动态验证码设置

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如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