在 Mac 上安装 ComfyUI

本指南提供在 Mac 系统上安装 ComfyUI 的分步指导。

Mac 系统要求

组件要求
系统macOS 13+ (Ventura)
芯片推荐使用 Apple Silicon (M1/M2/M3/M4)；Intel Mac 支持但性能有限
内存至少 8 GB，推荐 16 GB
存储SSD，至少 20 GB 可用空间（仅 ComfyUI 自身最低要求——实际模型下载量很快可达 50–100 GB+）
浏览器推荐 Chrome 143+

如果你的 Mac 搭载的是 Apple Silicon 芯片还是 Intel 芯片，运行 ComfyUI 的最佳方式会有所不同。

ℹ️ 关于更新的说明： 有关最新的 Desktop 安装信息，请查看官方文档。

Comfy Desktop（推荐）

Comfy Desktop 是官方桌面应用程序，也是在 macOS 上运行 ComfyUI 的最简单方式。它会自动处理安装、Python 环境和依赖关系，并在 Apple Silicon 上使用 Metal Performance Shaders (MPS) 进行 GPU 加速。

→ Comfy Desktop 安装指南

Comfy CLI

你也可以使用 Comfy CLI 在 Mac 上安装 ComfyUI。它适用于安装 Python 3.12 或 3.13 的 Apple Silicon 和 Intel Mac。

→ Comfy CLI 完整指南

手动安装

对于希望完全掌控的高级用户，可以从 GitHub 克隆仓库并手动搭建环境：

# 1. 克隆仓库
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

# 2. 创建虚拟环境
python3 -m venv .venv

# 3. 激活环境
source .venv/bin/activate

# 4. 安装带 Metal 支持的 PyTorch（Apple Silicon）
pip install --pre torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/nightly/cpu

# 5. 安装 ComfyUI 依赖项
pip install -r requirements.txt

# 6. 启动 ComfyUI
python main.py

在 Apple Silicon Mac 上，ComfyUI 使用 Metal Performance Shaders (MPS) 进行 GPU 加速，对大多数模型都能提供不错的性能。

注意：在没有独立 GPU 的 Intel Mac 上，性能会受限，通常只能使用 CPU 模式。强烈建议使用 Apple Silicon Mac 以获得流畅的体验。