Nunchaku FLUX.1-dev部署教程:comfy-cli一键安装与版本管理

发布时间:2026/5/25 0:49:09

Nunchaku FLUX.1-dev部署教程:comfy-cli一键安装与版本管理 Nunchaku FLUX.1-dev部署教程comfy-cli一键安装与版本管理想试试最近很火的Nunchaku FLUX.1-dev模型但被复杂的安装步骤劝退别担心这篇教程就是为你准备的。我会带你用最简单的方法在ComfyUI里快速部署这个强大的文生图模型从环境准备到生成第一张图片全程手把手教学。无论你是刚接触AI绘画的新手还是想尝鲜新模型的老玩家跟着这篇教程走10分钟就能搞定。我们主要用comfy-cli这个工具它能帮你省去很多手动配置的麻烦特别适合想快速上手的同学。1. 准备工作检查你的电脑环境在开始安装之前我们先花一分钟确认下你的电脑是否满足基本要求。这就像做饭前要准备好锅碗瓢盆一样基础打好了后面才不会出问题。1.1 硬件要求Nunchaku FLUX.1-dev对显卡有一定要求主要是显存推荐配置NVIDIA显卡显存24GB或以上。这个配置能流畅运行FP16精度的完整模型。中等配置显存12-16GB。可以选择INT4量化版模型效果也不错显存占用会小很多。最低要求显存8GB。可以考虑FP8量化版虽然效果略有折扣但能跑起来。特别注意如果你用的是最新的Blackwell架构显卡比如RTX 50系列需要选择FP4量化版模型。简单说显存越大越好。如果显存不够后面我们会教你怎么选量化版本来解决。1.2 软件环境软件方面需要准备三样东西Python 3.10或更高版本这是运行AI模型的基础。你可以在命令行输入python --version来查看当前版本。Git用来下载代码和模型。大部分系统应该都自带了如果没有去Git官网下载安装就行。PyTorch深度学习的核心框架。不过别担心我们后面用comfy-cli安装时会自动配置合适的版本。1.3 提前安装一个小工具在正式开始前我们先装一个下载模型会用到的工具pip install --upgrade huggingface_hub这个命令会在你的电脑上安装huggingface_hub后面下载模型时要用到。如果安装速度慢可以试试加上国内镜像源pip install --upgrade huggingface_hub -i https://pypi.tuna.tsinghua.edu.cn/simple好了环境检查完毕我们进入正题。2. 安装ComfyUI和Nunchaku插件这是最核心的一步我们会用两种方法安装第一种是用comfy-cli一键安装推荐给新手第二种是手动安装适合喜欢自己掌控一切的同学。2.1 方法一comfy-cli一键安装最简单如果你想要最省事的安装方式选这个方法就对了。comfy-cli是ComfyUI的官方命令行工具能自动处理很多依赖和配置。2.1.1 安装comfy-cli打开命令行Windows用CMD或PowerShellMac/Linux用终端输入pip install comfy-cli等安装完成后输入comfy --version看看是否安装成功。如果显示版本号说明没问题。2.1.2 安装ComfyUI接下来用comfy-cli安装ComfyUI本体comfy install这个命令会自动下载ComfyUI的最新版本并安装所有必需的依赖包。过程中可能会下载一些比较大的文件耐心等待就好。2.1.3 安装Nunchaku插件ComfyUI安装好后我们来安装Nunchaku插件comfy noderegistry-install ComfyUI-nunchaku安装完成后需要把插件移动到正确的位置mv ComfyUI-nunchaku ComfyUI/custom_nodes/nunchaku_nodes这样插件就安装好了。是不是很简单整个过程基本上就是输入几个命令然后等着就行。2.2 方法二手动安装更灵活如果你对ComfyUI比较熟悉或者想要更自定义的安装方式可以选这个方法。2.2.1 手动安装ComfyUI首先下载ComfyUI的代码git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI然后安装依赖pip install -r requirements.txt2.2.2 手动安装Nunchaku插件进入ComfyUI的自定义节点目录下载Nunchaku插件cd custom_nodes git clone https://github.com/mit-han-lab/ComfyUI-nunchaku nunchaku_nodes手动安装的好处是你可以随时查看代码或者修改一些配置。不过对新手来说还是推荐用第一种方法。2.3 安装Nunchaku后端从v0.3.2版本开始Nunchaku插件简化了后端安装。你只需要在ComfyUI的网页界面里找到Nunchaku相关的节点它应该会自动提示你安装所需的后端wheel包。如果没自动提示你也可以在插件目录里找找有没有install_wheel.json这样的配置文件按照说明操作就行。3. 下载模型文件插件装好了现在需要下载模型文件。Nunchaku FLUX.1-dev需要几个不同的模型文件我们一个个来。3.1 准备示例工作流先来配置一下工作流这样等会儿在网页界面里就能直接用了# 进入ComfyUI根目录 cd ComfyUI # 创建工作流目录如果不存在的话 mkdir -p user/default/example_workflows # 复制Nunchaku的示例工作流 cp custom_nodes/nunchaku_nodes/example_workflows/* user/default/example_workflows/这个操作是把插件自带的示例工作流复制到ComfyUI能识别的位置。3.2 下载基础FLUX模型FLUX.1-dev需要一些基础模型组件包括文本编码器和VAE可变分自编码器。3.2.1 下载文本编码器文本编码器负责理解你输入的文字描述。需要下载两个# 下载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这两个文件都不大下载很快。它们会被自动放到ComfyUI/models/text_encoders/目录下。3.2.2 下载VAE模型VAE负责把模型生成的潜变量转换成最终的图片hf download black-forest-labs/FLUX.1-schnell ae.safetensors --local-dir models/vae这个文件也不大。下载后会在ComfyUI/models/vae/目录里。小提示如果你之前下载过这些模型或者想用本地已有的文件可以创建软链接来节省空间。比如# 查看文本编码器目录 ls -l models/text_encoders/ # 如果显示的是软链接像这样 # clip_l.safetensors - /root/.cache/huggingface/FLUX.1-dev/text_encoders/clip_l.safetensors # t5xxl_fp16.safetensors - /root/.cache/huggingface/FLUX.1-dev/text_encoders/t5xxl_fp16.safetensors # 查看VAE目录 ls -l models/vae/ # ae.safetensors - /root/.cache/huggingface/FLUX.1-dev/vae/ae.safetensors这说明模型文件已经通过软链接的方式准备好了。3.3 下载Nunchaku FLUX.1-dev主模型这是最核心的部分也是文件最大的一个。你需要根据显卡类型选择不同的版本显卡类型推荐模型版本显存占用适合场景Blackwell架构RTX 50系列FP4量化版约8-10GB最新显卡专用其他NVIDIA显卡INT4量化版约10-12GB大多数用户的选择显存不足8GB左右FP8量化版约17GB平衡效果和显存显存充足24GBFP16完整版约33GB追求最佳效果对于大多数用户我推荐INT4量化版它在效果和显存占用之间取得了很好的平衡。下载INT4版本hf download nunchaku-tech/nunchaku-flux.1-dev svdq-int4_r32-flux.1-dev.safetensors --local-dir models/unet/这个文件大概10GB左右下载时间取决于你的网速。下载完成后它会在ComfyUI/models/unet/目录里。同样如果你有本地文件可以创建软链接ls -l models/unet/ # 应该能看到类似这样的软链接 # svdq-int4_r32-flux.1-dev.safetensors - /path/to/your/model.safetensors3.4 下载可选LoRA模型增强效果LoRA是小型的适配器模型可以微调生成效果。虽然不是必须的但用了之后效果会更好。常用的LoRA有FLUX.1-Turbo-Alpha加速生成减少步数Ghibsky Illustration吉卜力动画风格其他风格LoRA根据你的喜好选择下载LoRA到指定目录# 假设你已经下载了LoRA文件创建软链接 ls -l models/loras/ # 可能会看到 # diffusion_pytorch_model.safetensors - /path/to/lora1.safetensors # lora_v2.safetensors - /path/to/lora2.safetensors如果你还没有LoRA文件可以去Hugging Face或Civitai等平台搜索下载。4. 启动ComfyUI并生成第一张图片所有准备工作都完成了现在让我们启动ComfyUI看看效果如何。4.1 启动ComfyUI在ComfyUI的根目录下运行python main.py如果你用的是comfy-cli安装的也可以这样启动comfy start启动成功后你会看到类似这样的信息Starting server To see the GUI go to: http://127.0.0.1:8188打开浏览器访问http://127.0.0.1:8188就能看到ComfyUI的界面了。4.2 加载Nunchaku工作流进入ComfyUI网页界面后我们需要加载专门为Nunchaku FLUX.1-dev准备的工作流。点击右上角的Load按钮选择user/default/example_workflows/目录找到并加载nunchaku-flux.1-dev.json这个文件这个工作流是专门优化过的支持多LoRA加载文生图效果最好。加载后你会看到一个已经配置好的节点图。如果提示缺少某些节点可能是因为你还没安装对应的自定义节点。这时候可以通过ComfyUI Manager安装缺失的节点或者手动安装提示的节点4.3 配置参数并生成图片现在到了最激动人心的环节——生成第一张AI图片4.3.1 输入提示词在工作流中找到Prompt节点通常会有明显的输入框输入你的描述。FLUX模型对英文提示词支持更好所以建议用英文描述。试试这些例子A beautiful landscape with mountains and lakes, ultra HD, realistic, 8K美丽的山水风景A cute cartoon cat wearing glasses, reading a book, studio lighting戴眼镜看书的卡通猫Cyberpunk city at night, neon lights, rain, futuristic, detailed赛博朋克夜城4.3.2 调整参数可选如果你对生成效果有特定要求可以调整这些参数推理步数Steps一般20-30步效果就不错了。如果开了FLUX.1-Turbo-AlphaLoRA可以降到10-15步。分辨率Resolution默认可能是1024x1024。显存不够的话可以降到768x768或512x512。CFG Scale控制模型跟随提示词的程度7-10之间比较合适。Sampler采样器默认的DPM 2M Karras就不错。LoRA权重如果加载了LoRA可以调整权重通常0.5-1.0。4.3.3 生成图片点击界面上的Queue Prompt按钮开始生成第一次生成可能会慢一些因为模型需要加载到显存。后续生成就会快很多。生成完成后图片会显示在右边的预览区域。小技巧如果生成速度慢可以尝试降低分辨率减少推理步数使用量化版模型开启FLUX.1-Turbo-AlphaLoRA5. 常见问题与注意事项在实际使用中你可能会遇到一些问题。这里我整理了一些常见的情况和解决方法。5.1 模型文件放错位置这是最容易出错的地方。请确认你的模型文件都在正确的位置ComfyUI/models/ ├── unet/ # Nunchaku FLUX.1-dev主模型 │ └── svdq-int4_r32-flux.1-dev.safetensors ├── loras/ # LoRA模型可选 │ ├── flux.1-turbo-alpha.safetensors │ └── other-lora.safetensors ├── text_encoders/ # 文本编码器 │ ├── clip_l.safetensors │ └── t5xxl_fp16.safetensors └── vae/ # VAE模型 └── ae.safetensors如果位置不对ComfyUI会找不到模型生成时就会报错。5.2 显存不足问题如果你在生成图片时遇到显存不足的错误可以尝试这些方法使用量化模型从FP16换成INT4或FP8版本降低分辨率从1024x1024降到768x768或512x512减少批处理大小一次只生成一张图关闭其他程序特别是其他占用显存的AI应用或游戏使用--lowvram参数启动ComfyUI时加上这个参数启动命令示例python main.py --lowvram5.3 生成效果不理想如果生成的图片质量不好或者不符合你的描述检查提示词用英文、描述具体、避免矛盾词汇调整CFG Scale太低会不跟提示词太高会过度饱和增加推理步数特别是关闭Turbo LoRA时至少20步尝试不同采样器DPM 2M Karras、Euler等使用负面提示词描述你不想要的内容5.4 工作流节点缺失加载工作流时如果提示节点缺失通过ComfyUI Manager安装这是最简单的方法手动安装缺失节点按照提示的节点名去GitHub搜索安装检查插件是否安装正确确认nunchaku_nodes在custom_nodes目录里5.5 生成速度慢第一次生成慢是正常的模型加载。如果后续生成也慢使用Turbo LoRAFLUX.1-Turbo-Alpha能显著加速降低分辨率小图生成更快减少推理步数15-20步通常足够检查硬件确保没有其他程序占用大量资源6. 总结与进阶建议恭喜你现在你应该已经在ComfyUI里成功部署了Nunchaku FLUX.1-dev并且生成了第一张图片。让我们回顾一下关键步骤6.1 核心步骤回顾环境准备检查显卡、Python版本安装必要工具安装ComfyUI和插件用comfy-cli一键安装最省事下载模型文件基础模型主模型可选LoRA注意存放位置启动和配置加载工作流输入提示词调整参数生成图片点击运行等待结果整个过程其实并不复杂主要是模型文件比较大下载需要一些时间。一旦部署完成后面使用就很方便了。6.2 下一步可以尝试的如果你已经掌握了基本用法可以试试这些进阶玩法尝试不同风格下载更多LoRA模型体验不同艺术风格调整工作流在ComfyUI里自定义节点连接实现更复杂的效果批量生成写脚本批量处理提示词提高效率与其他模型结合尝试ControlNet、IP-Adapter等控制生成优化提示词学习提示词工程让生成效果更精准6.3 最后的小建议定期更新ComfyUI和插件都在不断更新记得偶尔更新一下备份工作流好的工作流配置记得导出保存加入社区遇到问题可以去GitHub Issues或相关论坛提问耐心实验AI生成需要一些尝试和调整不要期望一次就完美Nunchaku FLUX.1-dev是一个很强大的文生图模型特别是在细节和一致性方面表现不错。虽然部署过程看起来步骤不少但跟着教程一步步来其实并不难。最重要的是开始动手尝试。先按照教程走一遍生成几张图看看效果。熟悉了基本操作后再慢慢探索更多高级功能。AI绘画的魅力就在于你永远不知道下一张图会是什么样子——这种不确定性正是创造的乐趣所在。获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。

相关新闻