# 🖥️ Mac mini ComfyUI 环境搭建
> 从零开始在 Mac mini 上搭建 ComfyUI，包括 Homebrew、Python 3.13、虚拟环境和依赖安装，国内网络可用。
---
## 🔹 背景说明
📌 日常工作中需要使用 ComfyUI 进行 AI 内容生成，但默认环境复杂，需要统一管理 Python 与依赖。
尝试过的方法：
- 🌐 **直接 Git 克隆** → ❌ 国内网络可能无法访问
- 💡 **Homebrew + Python + 虚拟环境 + ComfyUI ZIP** → ✅ 简单高效，适合国内用户
---
## 🔹 工具准备
| 工具 | 图标 | 用途 |
|------|------|------|
| Mac mini | 💻 | 本地计算与运行 ComfyUI |
| Homebrew | 🛠️ | 软件包管理 |
| Python 3.13 | 🐍 | Python 运行环境 |
| Git | 🔧 | 版本控制与源码获取 |
| VS Code | 🖊️ | Markdown 编辑与脚本调试 |
| 虚拟环境 venv | 📦 | 隔离 Python 依赖 |
---
## 🛠 安装与配置流程
```mermaid
flowchart TD
A1[💻 准备 Mac mini] --> B1[🛠 安装 Homebrew]
B1 --> C1[🐍 安装 Python 3.13]
C1 --> D1[🔧 创建 ComfyUI 目录]
D1 --> E1[📥 获取 ComfyUI 源码]
E1 --> F1[📦 创建虚拟环境]
F1 --> G1[⚡ 安装依赖]
G1 --> H1[▶️ 运行 ComfyUI]
```
---
## 1️⃣ 安装 Homebrew
> 💡 **提示** 蓝色信息框
> 打开终端执行：
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
🛠 添加 Homebrew 到 PATH：
```bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"
```
✅ 验证安装：
```bash
brew --version
```
---
## 2️⃣ 安装 Python 3.13
> 💡 提示
```bash
brew install python@3.13
```
📌 验证版本：
```bash
python3 --version
```
⚠️ **注意** 黄色警告框
如果 `python3` 指向系统 Python，设置 PATH：
```bash
echo 'export PATH="/opt/homebrew/opt/python@3.13/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
---
## 3️⃣ 创建 ComfyUI 目录
```bash
cd ~
mkdir -p ComfyUI
cd ComfyUI
rm -rf *
```
> 💡 提示
`rm -rf *` 删除目录下文件，但保留目录本身
---
## 4️⃣ 获取 ComfyUI 源码
### 方法 1：官方 GitHub
```bash
git clone https://github.com/comfyanonymous/ComfyUI.git .
```
### 方法 2：国内下载 ZIP
1. 下载 ZIP：[ComfyUI ZIP 下载](https://github.com/comfyanonymous/ComfyUI/archive/refs/heads/master.zip)
2. 解压到 ComfyUI 目录：
```bash
unzip ~/Downloads/master.zip -d ~/ComfyUI
mv ~/ComfyUI/ComfyUI-master/* ~/ComfyUI/
mv ~/ComfyUI/ComfyUI-master/.* ~/ComfyUI/ 2>/dev/null
rmdir ~/ComfyUI/ComfyUI-master
```
> 💡 提示：确保目录中只有 ComfyUI 文件，否则可能报错
---
## 5️⃣ 创建虚拟环境
```bash
python3 -m venv comfyui-venv
source comfyui-venv/bin/activate
```
> 💡 提示：激活后终端显示 `(comfyui-venv)`，依赖安装在虚拟环境内
---
## 6️⃣ 升级 pip
```bash
python3 -m pip install --upgrade pip
```
---
## 7️⃣ 安装 ComfyUI 所有依赖
```bash
python3 -m pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```
> 💡 提示：
> - 国内镜像加速
> - 若出现缺模块错误，可单独安装：
```bash
python3 -m pip install 模块名 -i https://pypi.tuna.tsinghua.edu.cn/simple
```
---
## 8️⃣ 运行 ComfyUI
```bash
python3 main.py
```
🌐 打开浏览器访问终端显示的地址（如 `http://127.0.0.1:8188`）即可使用 ComfyUI
---
## 9️⃣ 虚拟环境使用提示
- 激活虚拟环境：
```bash
cd ~/ComfyUI
source comfyui-venv/bin/activate
```
- 退出虚拟环境：
```bash
deactivate
```
---
## 🔄 更新 ComfyUI
```bash
cd ~/ComfyUI
git pull
python3 -m pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```
> ZIP 更新同理：重新下载覆盖旧文件，再安装依赖
---
## ⚠️ 注意事项
- 虚拟环境和 ComfyUI 必须在同一目录
- 国内环境推荐使用 PyPI 镜像
- 遇到 `ModuleNotFoundError`，可用 `pip install 模块名` 补充
- 虚拟环境保证系统 Python 干净，每次使用前激活
> ✅ 完成后，即可使用 ComfyUI 进行 AI 内容生成任务
---
🔙 [返回 OUTLINE.md](../../Outline.md)
