安装 ComfyUI

ComfyUI 是节点式本地生图前端，对新模型支持较快。
MiniTavern 通过 ComfyUI 的 HTTP API（/prompt 等）提交内置默认工作流；你无需在 App 里手写节点图即可出图。

官方文档：docs.comfy.org · 仓库：Comfy-Org/ComfyUI

硬件建议

显存	建议
6GB	SD 1.5 等较小工作流
8–12GB	SDXL、部分快速 Flux 变体更现实
Apple Silicon	可原生跑，一般慢于同级 NVIDIA

方式 A：Windows 便携包（推荐）

1. 打开 ComfyUI 发布页 / 官网下载（或社区提供的 ComfyUI_windows_portable 包）。
2. 解压到非系统盘路径（路径尽量短、无中文空格亦可）。
3. 有 NVIDIA 时运行 run_nvidia_gpu.bat；仅 CPU 时用对应 CPU 脚本。
4. 本机浏览器打开提示的地址，常见为：

http://127.0.0.1:8188

方式 B：Desktop 应用

1. 安装 ComfyUI Desktop。
2. 设置 → Server Configuration（或同类「服务器 / 网络」项）：
   • Listen Address 改为 0.0.0.0（默认 127.0.0.1 时手机连不上）
   • 记下 Port（Desktop 常见 8000，与便携版 8188 不同）
3. 重启后再用局域网 IP 访问。

方式 C：手动 Git（macOS / Linux / 进阶）

git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
python -m venv venv
# Windows: venv\Scripts\activate
source venv/bin/activate
pip install -r requirements.txt
# 按显卡安装匹配的 PyTorch（见 PyTorch 官网）
python main.py --listen

开启局域网（连手机必做）

便携包 / 命令行

编辑启动脚本（如 run_nvidia_gpu.bat），在 main.py 后增加：

--listen

完整示例：

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --listen

参数	作用
--listen	无参数时监听所有网卡，允许局域网访问
--port 8188	可选改端口
--enable-cors-header	浏览器跨域需要时再加；手机 App 直连 API 通常不必

Desktop

见上文：Listen 设为 0.0.0.0，端口以界面为准。

放置模型

将 checkpoint（.safetensors）放入：

ComfyUI/models/checkpoints/

在界面中按 R 刷新模型列表，或重启。先确保能在 ComfyUI 网页里手动跑通默认文生图，再连 App。

模型来源示例：Civitai · Hugging Face。

验证

本机：

http://127.0.0.1:8188

局域网（换成电脑 IP；Desktop 注意端口）：

http://192.168.x.x:8188

手机浏览器能打开同一地址，说明网络与监听正常。

与 MiniTavern 的差异（请先读）

• App 使用内置默认 workflow，一般会选用你机器上可用的 checkpoint；复杂自定义节点图需自行改服务端，不在本教程范围。
• 当前版本默认 Comfy 流程不使用参考图（有参考图也不会报错）；需要参考图锁脸时请用 A1111 或支持参考图的云端平台。
• 电脑休眠、合盖后服务会停；IP 变更后需在 App 里改 Base URL。

下一步

• 在 MiniTavern 中配置
• 总览：生图模型部署