ComfyUI MOSS Image

安装教程 · 2026-10-21 核对

在 ComfyUI 里安装 MOSS-Image

MOSS-Image 用 ComfyUI 的核心节点就能运行，需要 v0.42.0 或更新版本的 ComfyUI、三个模型文件和一个工作流。本页按免安装版、git 安装和桌面版分别说明。

1. 确认 ComfyUI 版本

启动日志里有一行类似下面的内容，设置 → 关于里也能看到同样的版本号。MOSS-Image 需要 0.42.0 或更新版本：支持代码 10-16 合入，10-18 发布的 v0.42.0 是第一个包含它的正式版。ComfyUI 文档写 0.41.3 就够，但 0.41.3 并不包含这次支持。

ComfyUI version: 0.42.1

2. 更新或安装 ComfyUI

Windows 免安装版（portable）

新装：在 v0.42.1 发布页下载 ComfyUI_windows_portable_nvidia.7z（约 2 GB），用 7-Zip 解压后运行 run_nvidia_gpu.bat。已经装过：运行 update 文件夹里的 update_comfyui_stable.bat，更新到最新正式版；update_comfyui.bat 则会更新到最新提交。两个脚本都会在依赖变化时自动重装 Python 依赖。

update\update_comfyui_stable.bat

手动安装（git）

在 ComfyUI 目录运行 git pull（或 git checkout v0.42.1），再用同一个 Python 环境运行 pip install -r requirements.txt。第二条不能省：v0.42.0 指定了 comfyui-frontend-package 1.55.18 和 comfyui-workflow-templates 0.11.89，模板库里的模板就来自后面这个包。

git pull
pip install -r requirements.txt

Comfy Desktop（桌面版）

桌面版自带一份 ComfyUI 核心，它最新的正式版 v1.1.7 发布于 10-13，早于 ComfyUI v0.42.0。先看设置 → 关于：核心低于 0.42.0 就加载不了 MOSS-Image，桌面版跟进之前，先用免安装版或 git 安装。

3. 下载模型文件

需要一个扩散模型、Qwen3.5-9B 文本编码器和 FLUX.2 VAE。下面是模板默认的一套，约 13 GB；其他精度见按显存选文件。

文件大小下载
moss_image_sft_int8_convrot.safetensors5.41 GBHugging FaceModelScope
qwen3.5_9b_w4a8_gptq.safetensors7.34 GBHugging FaceModelScope
flux2-vae_small.safetensors0.25 GBHugging FaceModelScope

ModelScope（魔搭）的 Comfy-Org/MOSS-Image 下有同一套文件，文件名和字节数完全一致（10-21 核对），国内下载通常更快。

其他精度：按显存选文件

4. 把文件放进对应文件夹

路径相对于 ComfyUI 目录。放好后重启 ComfyUI，加载节点才会列出新文件。

ComfyUI/
└── models/
    ├── diffusion_models/
    │   └── moss_image_sft_int8_convrot.safetensors
    ├── text_encoders/
    │   └── qwen3.5_9b_w4a8_gptq.safetensors
    └── vae/
        └── flux2-vae_small.safetensors

5. 打开工作流

打开模板库搜索「MOSS-Image」，或者在本站工作流页复制任意一个，到 ComfyUI 画布上按 Ctrl+V。每个工作流都带有模型文件和下载链接，缺哪个文件 ComfyUI 会提示。

获取工作流

6. 出第一张图

第一次先用模板默认参数：25 步、CFG 2.5、er_sde 采样器、约 1 MP。提示词要描述成图本身，短提示词会被自动扩写。

出错了怎么办

「Could not detect model type」、dtype 报错等常见问题和解决办法，都整理在首页。

查看报错排查

来源： ComfyUI v0.42.1 release · portable update.py · v0.42.0 requirements.txt · Comfy Desktop releases · ComfyUI v0.42.0 · Comfy-Org/MOSS-Image · ModelScope Comfy-Org/MOSS-Image · docs.comfy.org