AI绘画新神器：Nunchaku FLUX.1-dev在ComfyUI中的保姆级安装教程

AI绘画新神器Nunchaku FLUX.1-dev在ComfyUI中的保姆级安装教程你是不是也见过那些细节炸裂、光影绝美的AI绘画作品心里痒痒的但一看到复杂的安装步骤和命令行就打了退堂鼓别担心今天这篇教程就是为你准备的。我们将手把手教你如何在ComfyUI这个强大的可视化工具里部署目前最受关注的Nunchaku FLUX.1-dev文生图模型。你不需要是程序员也不需要理解复杂的AI原理只需要跟着这篇保姆级教程一步步操作就能在自己的电脑上运行这个顶级的AI画师。1. 准备工作理清思路事半功倍在动手之前我们先花几分钟了解整个流程的脉络这样操作起来心里有底遇到问题也知道该往哪个方向解决。1.1 你需要准备什么整个过程对硬件和软件有一些基本要求但别担心大部分现代电脑都能满足。硬件要求一台配备NVIDIA显卡的电脑。这是运行AI模型的计算核心。显存GPU内存是关键越大越好。FLUX.1-dev模型有不同的版本适配不同显存从8GB到24GB以上都有对应方案我们后面会详细说明。软件环境需要安装Python推荐3.10或更高版本和Git。这些都是免费的开源工具安装过程很简单。网络条件需要一个稳定的网络连接来下载模型文件。模型文件大小从几GB到几十GB不等下载时间取决于你的网速。心态准备第一次部署可能会遇到一些小问题这非常正常。教程里包含了详细的步骤和常见问题排查只要耐心跟着做一定能成功。1.2 认识主角Nunchaku FLUX.1-dev是什么你可以把Nunchaku FLUX.1-dev想象成一个经过特殊训练的“天才画师大脑”。它基于最新的FLUX架构有几个突出的特点理解力超强它对文字描述我们称之为“提示词”的解读非常精准。你说“一只在月光下梳理羽毛的凤凰”它不太会画成“一只在太阳下的公鸡”。画质细腻能够生成细节丰富、构图合理的高分辨率图像在光影、材质的表现上尤其出色。效率不错在同类效果的模型中它的生成速度相对较快让你不用等待太久就能看到成果。1.3 认识舞台ComfyUI是什么ComfyUI是一个基于节点的可视化AI工作流工具。听起来有点专业但其实它的理念很简单不用写代码所有的操作比如选择模型、输入文字、调整参数、后期处理都通过拖拽和连接一个个功能“盒子”节点来完成。所见即所得。流程透明整个图片从无到有的生成过程像流程图一样清晰展示在你面前。你可以清楚地知道每一步在做什么。极其灵活对于高级用户可以像搭乐高一样组合出极其复杂和定制化的图像处理流水线。但对于我们新手直接使用别人搭建好的、现成的“工作流”就行非常简单。简单来说ComfyUI就是我们用来指挥和调度“天才画师大脑”FLUX.1-dev模型的操作台和控制面板。2. 第一步搭建舞台——安装ComfyUI与Nunchaku插件这是最基础的一步我们会提供两种方法一种是最省事的“一键安装”另一种是更透明可控的“手动安装”。请根据你的喜好选择一种即可。2.1 方法A使用Comfy-CLI一键安装推荐新手这个方法通过一个叫comfy-cli的官方工具自动化完成大部分安装步骤非常方便。打开你的命令行终端Windows上是CMD或PowerShellMac/Linux上是Terminal依次输入并执行以下命令# 1. 安装ComfyUI的官方命令行管理工具 pip install comfy-cli # 2. 安装ComfyUI本体如果之前从未安装过 comfy install # 执行后它会询问安装路径直接按回车使用默认路径即可。 # 3. 通过节点仓库安装Nunchaku插件 comfy noderegistry-install ComfyUI-nunchaku # 4. 将安装好的插件移动到ComfyUI的正确目录下 # 假设ComfyUI安装在默认位置执行以下命令 mv ComfyUI-nunchaku ComfyUI/custom_nodes/nunchaku_nodes操作要点和提示请一行一行地复制命令执行完一行看到命令提示符再次出现后再复制下一行。如果执行第一行时提示“pip不是内部或外部命令”说明你的Python环境没有正确配置或者没有安装Python。你需要先安装Python并在安装时务必勾选“Add Python to PATH”选项。第4步的mv命令在Windows的PowerShell中可能不识别。如果遇到错误你可以手动操作找到刚刚通过comfy noderegistry-install命令生成的ComfyUI-nunchaku文件夹将其剪切或复制到ComfyUI目录下的custom_nodes文件夹里并将其重命名为nunchaku_nodes。2.2 方法B手动安装适合喜欢了解每一步的你如果你希望完全掌控安装过程或者方法A遇到了问题可以尝试这个手动安装方法。# 1. 克隆下载ComfyUI的源代码仓库 git clone https://github.com/comfyanonymous/ComfyUI.git # 进入刚刚下载的ComfyUI目录 cd ComfyUI # 2. 安装ComfyUI运行所需的所有Python依赖包 pip install -r requirements.txt # 3. 进入ComfyUI的自定义节点目录并克隆Nunchaku插件 cd custom_nodes git clone https://github.com/mit-han-lab/ComfyUI-nunchaku nunchaku_nodes完成以上任意一种方法后ComfyUI和Nunchaku插件就安装好了。插件本质上就是一系列扩展ComfyUI功能的Python脚本。3. 第二步请画师就位——下载模型文件现在“操作台”ComfyUI和“画笔工具”Nunchaku插件都准备好了我们需要把“画师大脑”模型文件请过来。这是最耗时的一步因为模型文件比较大。我们需要下载两类模型文件基础模型这是FLUX系列模型通用的“基础知识库”比如如何理解语言、如何构成图像的基本元素。所有FLUX模型都需要它们。核心模型这就是Nunchaku FLUX.1-dev“画师”本身包含了它独特的绘画风格和能力。3.1 下载基础模型必须下载首先确保你的命令行终端当前位于ComfyUI文件夹的根目录下。然后依次执行以下命令来下载基础模型# 下载文本编码器模型让AI理解你的文字描述 # 这会下载到 models/text_encoders/ 目录下 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模型负责将AI内部的“概念”解码成最终的图像像素 # 这会下载到 models/vae/ 目录下 hf download black-forest-labs/FLUX.1-schnell ae.safetensors --local-dir models/vae重要提示hf命令来自huggingface_hub这个Python库。如果系统提示“hf不是内部或外部命令”你需要先安装这个库命令是pip install huggingface_hub。3.2 下载核心的Nunchaku FLUX.1-dev模型根据显卡选择这是最关键的一步。FLUX.1-dev模型为了适配不同的硬件提供了多种“量化”版本。量化可以简单理解为在尽量保持画质的前提下对模型进行“瘦身”以减少显存占用和提升速度。请根据你的显卡情况选择下载下面其中一个版本即可模型版本适用显卡显存占用估算特点FP16 (完整版)RTX 3090, 4090, A100等显存24GB~33 GB画质最好但文件最大要求最高。INT4 (推荐)RTX 3060 12G, 4060 Ti 16G, 4070等显存8-16GB~8-12 GB最推荐的主流选择在画质损失极小的情况下显存占用大幅降低。FP8显存较为紧张的用户如8GB~17 GB比INT4占用稍多但也是高效的量化版本。FP4仅限最新的Blackwell架构显卡如未来的RTX 5090最低为最新显卡架构优化。这里以最通用、最推荐的INT4版本为例下载命令如下# 下载INT4量化版的主模型文件 # 这会下载到 models/unet/ 目录下 hf download nunchaku-tech/nunchaku-flux.1-dev svdq-int4_r32-flux.1-dev.safetensors --local-dir models/unet/下载完成后检查一下ComfyUI/models/unet/目录下应该有一个名为svdq-int4_r32-flux.1-dev.safetensors的文件。4. 第三步登台表演——启动ComfyUI并开始创作4.1 启动ComfyUI服务所有文件就绪现在可以启动我们的AI绘画工作室了。在ComfyUI文件夹根目录下打开命令行输入python main.py等待程序启动。当你在命令行中看到类似“To see the GUI go to: http://127.0.0.1:8188”的输出时就说明启动成功了。打开你的浏览器Chrome、Firefox、Edge等在地址栏输入http://127.0.0.1:8188并访问你就能看到ComfyUI的图形化界面了。4.2 加载预设的Nunchaku工作流刚打开的ComfyUI界面是一片空白的画布。我们需要加载一个已经为我们搭建好的“绘画流水线”也就是工作流。点击界面右上角的“Load”加载按钮。在弹出的文件浏览器中导航到ComfyUI/user/default/example_workflows/目录这个目录在我们安装插件时通常已经自动创建并放置了示例文件。选择名为nunchaku-flux.1-dev.json的文件并打开。加载成功后画布上会出现许多相互连接的节点。不要被这个看似复杂的“电路图”吓到我们只需要与其中几个关键节点交互。4.3 输入创意生成你的第一幅AI画作现在让我们来实际使用这个“画师”。找到输入框在工作流中找到一个名为“CLIP Text Encode (Prompt)”的节点。这个节点通常有一个大的文本输入框。双击它输入你的英文描述。提示词技巧FLUX模型对英文提示词响应更好。描述可以结构化主体A cute corgi puppy wearing a superhero cape环境/场景standing on a grassy hill at sunset风格/质量studio photography, sharp focus, 8k, highly detailed完整的例子A cute corgi puppy wearing a superhero cape, standing on a grassy hill at sunset, studio photography, sharp focus, 8k, highly detailed调整基本参数可选推理步数 (Steps)一般在20-50之间。步数越多AI“思考”得越久细节可能更丰富但耗时也更长。新手可以从25或30开始尝试。图片尺寸 (Width/Height)默认可能是1024x1024。这是生成高质量图的好尺寸但如果你的显存较小如8GB首次尝试可以调整为768x768或512x512以避免显存错误。采样器 (Sampler)和调度器 (Scheduler)工作流中通常已经设置好如dpmpp_2m和karras初次使用可以保持默认。点击生成在界面右侧找到“Queue Prompt”按钮大胆点击它等待与欣赏下方的进度条会开始走动右侧的预览区域会从模糊逐渐变得清晰。稍等片刻时间取决于你的显卡、步数和图片尺寸你的专属AI画作就诞生了5. 常见问题与进阶技巧第一次使用遇到问题很正常这里汇总了最常见的几个“坑”及其解决方法。5.1 运行时报错 “CUDA out of memory” 或 “显存不足”这是最可能遇到的问题。首要检查确认你下载的模型版本是否与你的显卡显存匹配。如果你只有8GB显存却错误下载了FP16完整版肯定会爆显存。请回头检查3.2节下载正确的INT4或FP8版本。降低分辨率在生成前将工作流中的Empty Latent Image节点里的宽度(Width)和高度(Height)调小例如从1024改为768。减少批次如果工作流中Batch Size大于1将其改为1即一次只生成一张图。使用--lowvram参数在启动ComfyUI时可以尝试使用python main.py --lowvram命令这会启用低显存模式但可能会降低速度。5.2 加载工作流时提示 “Missing Node Types”这意味着ComfyUI找不到Nunchaku插件提供的某些节点。解决方法确保ComfyUI-nunchaku插件已正确安装并且位于ComfyUI/custom_nodes/nunchaku_nodes目录下。安装后需要完全关闭ComfyUI服务器关闭命令行窗口然后重新运行python main.py启动这样新安装的插件才会被加载。5.3 生成的图片质量不佳、模糊或扭曲检查提示词避免使用过于抽象、复杂或自相矛盾的描述。从简单、具体的提示词开始尝试。确保足够步数如果你加载的工作流中FLUX.1-Turbo-Alpha这个LoRA节点被禁用关闭那么推理步数(Steps)绝对不能低于20否则画面会无法正常生成。建议保持在25-50之间。尝试不同采样器在工作流中找到KSampler节点尝试将采样器(Sampler)从默认的dpmpp_2m换成euler或dpmpp_3m_sde有时会产生不同的风格效果。5.4 如何控制生成效果让它更听话学习提示词工程这是AI绘画的核心。多观察优秀作品的提示词结构学习使用质量词如masterpiece, best quality、风格词如digital art, oil painting、灯光词如cinematic lighting等。使用负面提示词在工作流中找到另一个CLIP Text Encode节点它可能被标记为(Negative Prompt)。在这里输入你不希望在画面中出现的东西例如blurry, ugly, deformed, bad anatomy, extra fingers可以有效过滤掉一些常见的图像缺陷。调整CFG Scale在KSampler节点中有一个CFG Scale参数通常默认是7-9。这个值控制AI在多大程度上遵循你的提示词。调高如10-12会更贴近描述但可能死板调低如5-7会更有创意但可能偏离主题。6. 总结从安装到创作你的AI画室已就绪恭喜你至此你已经完成了一个功能强大的本地AI绘画环境的搭建。让我们快速回顾一下核心步骤理解框架明白了ComfyUI是操作台Nunchaku FLUX.1-dev是画师大脑。搭建环境通过一行行简单的命令安装了ComfyUI和必要的插件。准备模型根据自己显卡的“体力”显存下载了合适版本的“画师大脑”。启动应用运行ComfyUI在浏览器中打开了这个可视化创作工具。开始创作加载现成的工作流输入文字描述点击生成见证了从文字到图像的魔法。这个过程的核心逻辑非常清晰安装软件 → 放置模型 → 启动使用。一旦这个环境搭建成功它就成为了你随时可用的私人AI艺术工作室。未来的每一次创作都只是打开浏览器、输入想法、点击生成这么简单。真正的乐趣现在才开始。不要止步于第一张图大胆地去尝试各种天马行空的描述组合不同的艺术风格探索参数带来的微妙变化。Nunchaku FLUX.1-dev是一个能力强大的工具而你的想象力是它的唯一边界。现在就去创造那些只存在于你脑海中的美妙画面吧获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。