当前位置：首页 > news >正文

新手友好！ComfyUI安装Nunchaku FLUX.1-dev插件及模型全流程

news 2026/6/1 2:37:14

新手友好！ComfyUI安装Nunchaku FLUX.1-dev插件及模型全流程

你是否也想体验最新的AI绘画技术，却被复杂的安装步骤劝退？本文将带你从零开始，一步步完成ComfyUI中Nunchaku FLUX.1-dev插件的安装与配置，让你轻松上手这款强大的文生图模型。

1. 环境准备与基础检查

在开始安装前，我们需要确保系统满足基本运行要求。这些准备工作能避免后续安装过程中出现兼容性问题。

1.1 硬件要求

Nunchaku FLUX.1-dev模型对硬件有一定要求：

显卡：必须使用支持CUDA的NVIDIA显卡
显存：推荐24GB及以上（FP16版本）
替代方案：显存不足可选择FP8或INT4量化版本

1.2 软件依赖

确保系统中已安装以下基础软件：

# 检查Python版本（需要3.10+） python --version # 安装必要的工具 pip install --upgrade huggingface_hub

2. 插件安装：两种方法任选其一

Nunchaku FLUX.1-dev作为ComfyUI的插件，提供两种安装方式，新手推荐使用第一种方法。

2.1 方法A：Comfy-CLI一键安装（推荐）

这是最简单的安装方式，适合大多数用户：

# 安装ComfyUI命令行工具 pip install comfy-cli # 安装ComfyUI本体（已安装可跳过） comfy install # 安装Nunchaku插件 comfy noderegistry-install ComfyUI-nunchaku # 移动插件到正确位置 mv ComfyUI-nunchaku ComfyUI/custom_nodes/nunchaku_nodes

2.2 方法B：手动安装（适合高级用户）

如果你需要更多控制权，可以选择手动安装：

# 克隆ComfyUI仓库 git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI pip install -r requirements.txt # 安装Nunchaku插件 cd custom_nodes git clone https://github.com/mit-han-lab/ComfyUI-nunchaku nunchaku_nodes

3. 模型下载与配置

安装完插件后，需要下载并配置模型文件，这是生成图片的核心组件。

3.1 基础模型下载

FLUX.1-dev需要几个基础组件才能正常工作：

# 文本编码器模型 hf download comfyanonymous/flux_text_encoders clip_l.safetensors --local-dir models/text_encoders hf download comfyanonymous/flux_text_encoders t5xxl_fp16.safetensors --local-dir models/text_encoders # VAE模型 hf download black-forest-labs/FLUX.1-schnell ae.safetensors --local-dir models/vae

3.2 主模型选择与下载

根据你的显卡类型选择合适的模型版本：

显卡类型	推荐模型版本	显存占用
Blackwell架构	FP4	较低
其他NVIDIA显卡	INT4	中等
显存不足	FP8	最低

下载INT4版本主模型的命令：

hf download nunchaku-tech/nunchaku-flux.1-dev svdq-int4_r32-flux.1-dev.safetensors --local-dir models/unet/

3.3 工作流配置

将示例工作流复制到正确位置：

cd ComfyUI mkdir -p user/default/example_workflows cp custom_nodes/nunchaku_nodes/example_workflows/* user/default/example_workflows/

4. 启动与使用指南

一切准备就绪后，就可以开始生成你的第一张AI图片了。

4.1 启动ComfyUI

在ComfyUI根目录运行：

python main.py

启动后，在浏览器中访问http://127.0.0.1:8188即可打开界面。

4.2 加载工作流

在ComfyUI界面中加载适合的工作流：

nunchaku-flux.1-dev.json：完整功能版，支持多LoRA
nunchaku-flux.1-dev-qencoder.json：低显存版，效果稍逊

4.3 生成第一张图片

按照以下步骤操作：

在"positive prompt"输入框中输入英文描述（如："A beautiful sunset over mountains, 8K, highly detailed"）
调整参数：
- 推理步数：20-30步
- 分辨率：1024x1024（显存不足可降低）
点击"Queue Prompt"按钮开始生成