在ComfyUI中玩转Nunchaku FLUX.1-dev：从零部署到多语言文生图实战

想体验最新最强的开源文生图模型，但被复杂的部署步骤劝退？今天，咱们就来手把手搞定Nunchaku FLUX.1-dev在ComfyUI中的完整部署流程。这是一款基于FLUX架构的先进模型，支持多语言提示词，能生成细节惊人的高质量图像。更重要的是，通过ComfyUI的可视化节点，你可以像搭积木一样自由控制整个生成流程。

无论你是刚接触AI绘画的新手，还是想尝鲜最新模型的老玩家，这篇指南都会带你绕过所有坑，快速跑出第一张惊艳的图。

1. 准备工作：检查你的“画板”和“颜料”

在开始安装之前，咱们先看看你的电脑“画板”够不够大，“颜料”齐不齐全。这能帮你避免做到一半才发现跑不起来的尴尬。

1.1 硬件要求：你的显卡够力吗？

Nunchaku FLUX.1-dev对显卡有一定要求，主要是显存大小。别担心，它有不同版本适配各种配置：

• 推荐配置（畅玩版）：拥有24GB或以上显存的NVIDIA显卡。这样你可以运行完整的FP16精度模型，获得最好的图像质量。
• 主流配置（够用版）: 8GB-16GB显存的显卡。你需要选择INT4量化版模型，画质稍有妥协，但完全可用。
• 入门配置（尝鲜版）：如果显存更小，或者你用的是最新的Blackwell架构显卡（如RTX 50系列），可以选择FP8或FP4量化版模型，它们对显存要求更低。

简单来说，显存越大，能跑的模型精度越高，最终图片质量也越好。动手前，先在系统里查一下你的显卡型号和显存大小。

1.2 软件环境：把基础打好

软件环境就像画画的工具箱，缺一不可。请确保你的系统已经安装了以下工具：

1. Python 3.10或更高版本：这是运行所有AI模型的基础语言。在命令行输入 python --version 检查一下。
2. Git：用于从网上下载代码。通常系统会自带，如果没有，去官网下载安装一个。
3. PyTorch：深度学习的核心框架。你需要安装与你的系统和CUDA版本匹配的PyTorch。可以去PyTorch官网，用它的安装命令生成器获取准确的安装指令。
4. huggingface_hub：这是从Hugging Face平台下载模型的必备工具。在命令行运行下面这行命令来安装它：

pip install --upgrade huggingface_hub

环境准备好后，咱们就可以进入正题，开始安装ComfyUI和Nunchaku插件了。

2. 搭建舞台：安装ComfyUI与Nunchaku插件

ComfyUI是一个通过节点连接来工作的AI绘画工具，非常灵活。Nunchaku FLUX.1-dev需要以插件的形式安装到ComfyUI中。这里我给你两种安装方法，选一个你觉得顺手的就行。

2.1 方法一：用Comfy-CLI一键安装（最省心）

如果你喜欢命令行，并且希望步骤最少，这个方法最适合你。它用一个工具包办了所有事。

# 1. 安装ComfyUI的命令行管理工具
pip install comfy-cli

# 2. 安装ComfyUI本体（如果之前没装过）
comfy install

# 3. 安装Nunchaku插件
comfy noderegistry-install ComfyUI-nunchaku

# 4. 将插件移动到ComfyUI的正确目录
mv ComfyUI-nunchaku ComfyUI/custom_nodes/nunchaku_nodes

这几行命令依次完成了：安装工具、安装ComfyUI、搜索并安装Nunchaku插件、最后整理文件位置。全程自动化，几乎不用你操心。

2.2 方法二：手动安装（掌控感更强）

如果你想更清楚地知道文件都放在哪，或者网络环境特殊，手动安装是更好的选择。步骤稍多，但每一步你都能看到。

# 1. 下载ComfyUI的源代码
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI

# 2. 安装ComfyUI需要的所有Python依赖包
pip install -r requirements.txt

# 3. 进入自定义节点目录，下载Nunchaku插件
cd custom_nodes
git clone https://github.com/mit-han-lab/ComfyUI-nunchaku nunchaku_nodes

手动安装完成后，ComfyUI文件夹就是你的工作根目录，而插件位于 ComfyUI/custom_nodes/nunchaku_nodes。

2.3 安装Nunchaku后端引擎

插件只是操作界面，真正干活的“引擎”是Nunchaku后端。从v0.3.2版本开始，安装变得非常简单。插件安装好后，首次运行ComfyUI时，它通常会提示你安装或更新后端wheel包。你只需要在ComfyUI的网页界面里，根据提示点击确认即可完成。

如果网页没有自动提示，你也可以在ComfyUI启动后，在后台日志中查看相关指引。至此，舞台和演员都已就位，接下来需要准备“剧本”和“服装”——也就是模型文件。

3. 准备核心：下载与配置模型文件

Nunchaku FLUX.1-dev不是一个单一的模型文件，它由几个部分协同工作。我们需要把它们下载到正确的“更衣室”（目录）里。

3.1 第一步：放置工作流“剧本”

ComfyUI通过加载“工作流”（一个JSON文件）来定义生成图片的步骤。Nunchaku插件自带了一些示例工作流，我们把它复制到ComfyUI能识别的位置。

在你的ComfyUI根目录下（比如 ~/ComfyUI/），执行以下命令：

# 创建存放示例工作流的目录（如果不存在）
mkdir -p user/default/example_workflows

# 将Nunchaku插件自带的工作流复制过去
cp custom_nodes/nunchaku_nodes/example_workflows/* user/default/example_workflows/

这样，启动ComfyUI后，你就能在界面里直接加载这些预设好的工作流了。

3.2 第二步：下载模型“演员”和“服装”

这是最关键的一步，需要下载四种类型的模型文件。请根据你的显卡情况，选择对应的量化版本。

模型类型	作用	存放目录	推荐版本选择
文本编码器 (Text Encoder)	理解你的文字描述	models/text_encoders/	必装，通常用FP16版
VAE模型 (VAE)	将模型内部的数字转换成最终图片	models/vae/	必装
FLUX.1-dev主模型	图像生成的核心“大脑”	models/unet/	按显卡选：Blackwell卡用FP4，其他N卡用INT4，显存小吃紧用FP8
LoRA模型 (可选)	微调风格，比如漫画风、涡轮加速	models/loras/	按需下载，优化效果

开始下载：

打开命令行，进入你的ComfyUI根目录，然后依次执行以下命令。

1. 下载基础FLUX模型（必装）： 这两个模型是所有FLUX系列模型共用的基础。

# 下载CLIP文本编码器
hf download comfyanonymous/flux_text_encoders clip_l.safetensors --local-dir models/text_encoders

# 下载T5文本编码器（用于理解长文本）
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

2. 下载Nunchaku FLUX.1-dev核心模型（按需选择）： 这是生成图片的主力模型，请根据你的显卡情况选择一行命令执行。

# 适用于大多数NVIDIA显卡（非Blackwell），平衡速度和画质
hf download nunchaku-tech/nunchaku-flux.1-dev svdq-int4_r32-flux.1-dev.safetensors --local-dir models/unet/

# 如果你的显存非常充足（>=24GB），追求极致画质，可以用FP16版（注意文件名不同，需在HuggingFace页面确认）
# hf download nunchaku-tech/nunchaku-flux.1-dev [FP16模型文件名].safetensors --local-dir models/unet/

# 如果你的显卡是新一代Blackwell架构（如RTX 50系列），请使用FP4版本
# hf download nunchaku-tech/nunchaku-flux.1-dev [FP4模型文件名].safetensors --local-dir models/unet/

3. 下载可选LoRA模型（推荐）： LoRA像是给模型穿上不同风格的“外衣”。FLUX.1-Turbo-Alpha 这个LoRA可以显著加快生成速度，强烈建议下载。

# 下载加速LoRA（从HuggingFace或其他模型平台获取，此处为示例路径，请以实际为准）
# 假设模型名为 flux.1-turbo-alpha.safetensors，将其放入 loras 目录
# 你需要根据实际的模型发布页面找到下载链接或命令

所有模型下载完毕后，你的 ComfyUI/models/ 目录结构应该大致如下：

models/
├── text_encoders/
│   ├── clip_l.safetensors
│   └── t5xxl_fp16.safetensors
├── vae/
│   └── ae.safetensors
├── unet/
│   └── svdq-int4_r32-flux.1-dev.safetensors  # 或其他版本
└── loras/
    └── flux.1-turbo-alpha.safetensors  # (如果下载了)

万事俱备，只欠东风！现在可以启动ComfyUI，开始创作了。

4. 开始创作：启动ComfyUI并生成第一张图

4.1 启动ComfyUI服务

进入你的ComfyUI根目录，运行启动命令：

python main.py

稍等片刻，你会看到命令行输出一个本地网址，通常是 http://127.0.0.1:8188。用浏览器打开这个网址，你就进入了ComfyUI的图形化操作界面。

4.2 加载Nunchaku专属工作流

ComfyUI界面默认是空白的，我们需要加载之前准备好的“剧本”。

1. 在界面右侧，找到 “Load” （加载）按钮。
2. 点击后，在弹出的对话框中，导航至 ComfyUI/user/default/example_workflows/ 目录。
3. 选择 nunchaku-flux.1-dev.json 这个文件并打开。

加载成功后，你会看到一个已经连接好各种节点的复杂工作流。别被吓到，我们只需要关注几个关键输入点。

（上图展示了加载后的工作流界面，可以看到预设好的节点连接）

这个工作流已经配置好了多LoRA支持，是文生图效果最好的一个。如果加载时提示缺少某个节点，通常是因为依赖的自定义节点没装全，可以通过ComfyUI Manager（一个管理插件的插件）来搜索安装。

4.3 输入提示词并生成图片

现在来到最有趣的环节——把你的想法变成图片。

1. 找到提示词输入框：在工作流中，寻找标有 “Positive Prompt” 和 “Negative Prompt” 的节点。前者输入你想要的画面描述，后者输入你不想要的内容（比如“模糊的”、“多手指”）。
2. 输入描述：FLUX.1-dev对英文提示词的理解更好。试着输入一段描述，例如：
   • Positive Prompt: A beautiful landscape with mountains and lakes, ultra HD, realistic, 8K, sunset, cinematic lighting
   • Negative Prompt: blurry, deformed, ugly
3. 调整参数（可选）：
   • 推理步数 (Steps)：一般20-30步即可。请注意：如果你关闭了 FLUX.1-Turbo-Alpha 这个加速LoRA，步数必须调到至少20步，否则图片质量会很差。
   • 分辨率：默认可能是1024x1024。如果显存不足，可以降低到768x768或512x512。
   • 采样器 (Sampler) 和 调度器 (Scheduler)：工作流已预设好，初学者无需改动。
4. 点击生成：找到界面上的 “Queue Prompt” 按钮，点击它！右侧的预览区域会开始显示生成过程，稍等片刻，你的第一张Nunchaku FLUX.1-dev作品就诞生了。

（此区域用于输入正向和负向提示词，并控制生成参数）

5. 总结与进阶提示

恭喜你！至此，你已经成功在ComfyUI中部署并运行了强大的Nunchaku FLUX.1-dev模型。整个过程可以总结为三步：准备环境、安装插件与模型、加载工作流生成。这个模型的多语言支持特性，意味着你可以尝试用更自然、更复杂的语言去描述你脑海中的画面。

最后，分享几个能让体验更顺畅的要点：

• 目录别放错：这是最常见的错误。务必确认FLUX.1-dev主模型在 unet/ 文件夹，LoRA在 loras/ 文件夹。
• 显存是硬道理：如果生成时崩溃，大概率是显存不够。优先尝试降低输出图片的分辨率，或者换用更低精度的量化模型（如INT4换FP8）。
• 善用LoRA：FLUX.1-Turbo-Alpha LoRA能大幅提升生成速度，几乎是必备的。你还可以探索其他风格化LoRA，为你的作品注入特定画风。
• 探索工作流：除了我们用的这个，示例里还有其他工作流（如 nunchaku-flux.1-dev-qencoder.json），它们可能针对低显存做了优化，或者集成了其他功能，值得一试。
• 提示词的艺术：FLUX模型能理解非常细致的描述。多尝试组合不同的质量词（masterpiece, best quality）、风格词（anime style, oil painting）和细节词，你会发现它的潜力超乎想象。

现在，尽情发挥你的创意，让Nunchaku FLUX.1-dev帮你把天马行空的想法，变成一张张令人惊叹的视觉作品吧。从一张简单的风景描述开始，逐步尝试更复杂的人物、场景和概念，你会发现开源模型的世界同样精彩无限。

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。