想给网店做商品图、给公众号做配图,又不想每张图都按次付费,可以在 Mac 上本地运行 ComfyUI。下面用免费的开源模型 Z-Image-Turbo,从安装到生成第一张图走一遍。本文示例由本机生成;模型能理解中文提示词,也能尝试画中文字,但文字可能写错,交付前要检查。
本机生成的江南水乡橘猫示例,招牌文字仅供模型效果参考
准备一台 Apple 芯片 Mac、约 25GB 可用磁盘空间和稳定网络。本文在 M1 Max、64GB 内存的 Mac 上完成;ComfyUI 本身可以在较低配置运行,但这个 bf16 模型组合会占用较多内存,内存越小越容易变慢或失败。软件和模型免费,下载时间取决于网络。
先选安装方式
ComfyUI 是开源的本地 AI 工作流工具:把提示词、模型和图片处理步骤接成流程,再运行生成。Comfy Desktop 会代装运行环境,适合不想用终端的人;本教程用官方手动安装方式,因为模型放在哪个目录一目了然。Comfy Desktop 的 macOS 版要求 macOS 13 或更新版本、Apple 芯片;它会另外占用安装空间,模型仍需单独下载。官方安装说明
如果你没用过终端,先看终端入门和Python 与虚拟环境入门。
安装 ComfyUI
先安装 Git 和 uv。若已安装,跳过这一步;还没有 Homebrew 的话,可以先按Homebrew 官方说明安装。
brew install git uv
在终端运行下面的命令。它会把 ComfyUI 放在用户目录的 ai-demo/ComfyUI 中,并建立独立的 Python 环境,不会把依赖装进系统 Python。
mkdir -p ~/ai-demo && cd ~/ai-demo
git clone --depth 1 https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
uv venv --python 3.13
source .venv/bin/activate
uv pip install -r requirements.txt
依赖安装需要下载 PyTorch 等组件,耗时因网络而异。如果下载很慢或中断,先重新执行安装命令;不要另开一个 Python 环境重复安装。
下载模型文件
Z-Image-Turbo 的 ComfyUI 版本需要三个模型文件。ComfyUI 官方文档列出了每个文件的用途和目录;模型约占 20GB,建议先确认磁盘还有至少 25GB 空间。查看官方目录说明
| 文件 | 放入的目录 | 用途 |
|---|---|---|
z_image_turbo_bf16.safetensors |
models/diffusion_models/ |
生成图像 |
qwen_3_4b.safetensors |
models/text_encoders/ |
理解提示词 |
ae.safetensors |
models/vae/ |
解码图像 |
在 ComfyUI 根目录执行下面命令,从 ModelScope 上 Comfy-Org 的模型仓库下载。-C - 支持断点续传;中断后重跑对应命令即可。
cd ~/ai-demo/ComfyUI
mkdir -p models/diffusion_models models/text_encoders models/vae
BASE=https://modelscope.cn/models/Comfy-Org/z_image_turbo/resolve/master/split_files
curl -L --fail -C - "$BASE/diffusion_models/z_image_turbo_bf16.safetensors" -o models/diffusion_models/z_image_turbo_bf16.safetensors
curl -L --fail -C - "$BASE/text_encoders/qwen_3_4b.safetensors" -o models/text_encoders/qwen_3_4b.safetensors
curl -L --fail -C - "$BASE/vae/ae.safetensors" -o models/vae/ae.safetensors
如果你已经下载过模型,可以把文件放到上表对应位置;不要只改文件名,内容也必须是对应模型。Comfy Desktop 的模型位置由它的存储设置管理,不能直接照搬上面的 ~/ai-demo/ComfyUI/models/ 路径。
启动并打开模板
启动 ComfyUI:
cd ~/ai-demo/ComfyUI
source .venv/bin/activate
python main.py
终端显示 http://127.0.0.1:8188 后,在浏览器打开这个地址。保持终端窗口运行,关闭它会停止 ComfyUI。要结束运行,回到终端按 Control + C。
然后打开官方 Z-Image-Turbo 模板:
http://127.0.0.1:8188/?template=image_z_image_turbo
模板中有提示词、生成参数和图片保存节点。把提示词换成下面这段,点击右上角 Run:
一只橘猫趴在江南水乡的木窗台上晒太阳,窗外有小桥流水和白墙黑瓦。窗边挂着一块木招牌,牌子上写着“AI百宝箱”。午后暖光,生活方式摄影,画面自然,细节清晰。
第一张图可能需要等模型载入。生成结果会显示在页面里,也会保存在 ~/ai-demo/ComfyUI/output/。换提示词后再次点 Run,就会生成新图。
Z-Image-Turbo 模板界面示例
调整图片和提示词
- 尺寸:新手先保留模板默认值。尺寸越大,生成越慢,也越占内存。
- 随机种子:每次换种子,画面通常会变化;固定种子有助于复现同一次结果,但不能保证不同版本完全一致。
- 中文字:把需要出现的短文字用引号括起,并说明写在哪里。模型可能漏字、错字或画成相似字,招牌、包装和海报等正式用途要留出后期校字空间。
- 输出文件:在 Finder 中按
Command + Shift + G,输入~/ai-demo/ComfyUI/output,就能打开生成结果目录。
常见问题
模板里提示找不到模型:确认三个文件名和目录与表格一致,然后刷新 ComfyUI 页面。ComfyUI 官方说明,如果模板列表里没有 Z-Image-Turbo,也可能是 ComfyUI 或模板包版本较旧;更新后再试。官方工作流说明
生成时电脑变慢或失败:先关闭其他占内存的软件,再用较小的图片尺寸试一次。本文只在 64GB 内存的 M1 Max 上实测了这套 bf16 模型;官方 Desktop 对应用本身给出的 8GB 最低、16GB 推荐配置,不等同于这套模型的内存保证。Desktop 配置说明
下载中断:重新执行对应的 curl 命令,它会从已有部分继续下载。如果文件被改名或放错目录,ComfyUI 不会自动找到它。
工具与授权
Comfy-Org 发布的 Z-Image-Turbo ComfyUI 模型文件标注 Apache-2.0 许可,底座模型由通义实验室开发;ComfyUI 软件本身使用 GPL-3.0 许可。用于商业项目时,分别查看软件和模型许可,并检查输出图中的商标、人物肖像和其他受保护内容;发布时按客户或平台要求标注 AI 生成。模型许可 · ComfyUI 软件许可
接下来可以做什么
- 想把模型接入自己的图片工作流,可以看ComfyUI 常用工作流。
- 想知道节点都是什么,可以看ComfyUI 节点速查。