跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

FLUX.2 Klein 开源模型本地部署与使用指南

FLUX.2 Klein 是 Black Forest Labs 发布的轻量级 AI 绘画模型。该模型的硬件要求、环境配置以及两种本地部署方式(Python 脚本与 ComfyUI)。内容涵盖模型下载、显存优化、常见问题解决等实操步骤,旨在帮助开发者在消费级显卡上高效运行 AI 绘画任务,支持文生图、图生图及图像编辑功能。

BackendPro发布于 2026/4/5更新于 2026/10/24144 浏览
FLUX.2 Klein 开源模型本地部署与使用指南

前言

本文介绍 FLUX.2 Klein 开源模型的本地部署方案。

一、FLUX.2 Klein 特点

FLUX.2 Klein 是黑森林实验室(Black Forest Labs)最新发布的紧凑型 AI 绘画模型,主打亚秒级生成、低显存占用及全能编辑能力。

对比项FLUX.2 Klein(4B 版)FLUX.1SDXL 1.0
参数规模4B/9B(轻量化)12B3.5B
显存要求8GB+(RTX4060 可跑)16GB+10GB+
生成速度0.5-1 秒/张(1024×1024)2-3 秒/张5-8 秒/张
核心能力文生图 + 图生图 + 图像编辑仅文生图文生图 + 图生图
授权协议Apache-2.0(商用友好)非商用Apache-2.0

简单说:4B 版 8G 显存就能跑,速度快,支持图像编辑,商用友好。

二、部署前准备

1. 硬件要求
  • 显卡:NVIDIA RTX 3060 8GB/4060 8GB 及以上
  • 内存:16GB 及以上
  • 硬盘:预留 20GB 空间
  • 系统:Windows 10/11 或 Linux
2. 环境安装
# 1. 安装核心依赖
pip install -U diffusers transformers torch accelerate safetensors
# 2. 安装图像工具
pip install pillow matplotlib
# 3. 安装 huggingface 工具
pip install huggingface_hub

提示:如果下载慢,可换国内镜像源,在命令后加 -i https://pypi.tuna.tsinghua.edu.cn/simple

三、部署方案

方式 1:Python 脚本一键运行
步骤 1:创建运行脚本

新建文件 flux2_klein_demo.py,代码如下:

import torch
from diffusers import Flux2KleinPipeline
from PIL import Image

# 1. 加载模型
model_id = "black-forest-labs/FLUX.2-klein-4B"
dtype = torch.bfloat16

pipe = Flux2KleinPipeline.from_pretrained(
    model_id,
    torch_dtype=dtype,
    cache_dir="./models"
)


pipe.enable_model_cpu_offload()



prompt = 
negative_prompt = 

image = pipe(
    prompt=prompt,
    negative_prompt=negative_prompt,
    height=,
    width=,
    guidance_scale=,
    num_inference_steps=,
    generator=torch.Generator().manual_seed()
).images[]


image.save()
()
Image.().show()
# 2. 显存优化
# pipe.enable_vae_slicing()
# 3. 生成图片
"一只戴着墨镜的橘猫,坐在复古摩托车上,赛博朋克风格,高清细节,1024×1024"
"模糊,低分辨率,畸形,多余肢体,水印"
1024
1024
4.0
20
"cuda"
42
0
# 4. 保存并查看图片
"flux2_klein_cat.png"
print
"图片生成完成!已保存为 flux2_klein_cat.png"
open
"flux2_klein_cat.png"
步骤 2:运行脚本

在脚本所在文件夹打开终端,执行:

python flux2_klein_demo.py

首次运行会自动下载模型,后续运行直接生成图片。

方式 2:ComfyUI 可视化部署
步骤 1:安装 ComfyUI
git clone https://github.com/comfyanonymous/ComfyUI.git
cd ComfyUI
pip install -r requirements.txt
步骤 2:下载模型

将以下模型文件放入对应目录:

  • 文本编码器:ComfyUI/models/clip/
    • 下载地址:https://huggingface.co/black-forest-labs/FLUX.2-klein-4B/resolve/main/qwen_3_4b.safetensors
  • 扩散模型:ComfyUI/models/unet/
    • 下载地址:https://huggingface.co/black-forest-labs/FLUX.2-klein-4B/resolve/main/flux-2-klein-base-4b.safetensors
  • VAE 模型:ComfyUI/models/vae/
    • 下载地址:https://huggingface.co/black-forest-labs/FLUX.2-klein-4B/resolve/main/flux2-vae.safetensors
步骤 3:启动 ComfyUI
python main.py

访问 http://127.0.0.1:8188,选择工作流即可生成。

四、常见问题

1. 显存不足怎么办?
  • 换 4B 版模型
  • 开启 pipe.enable_model_cpu_offload()
  • 降低图片分辨率
  • 减少推理步数
2. 模型下载慢/失败?
  • 设置环境变量 HF_ENDPOINT=https://hf-mirror.com
  • 手动下载模型文件放到 ./models 目录
3. 生成效果不好?
  • 优化提示词
  • 调整 guidance_scale(4-6 最佳)
  • 尝试 9B 版模型

五、总结

FLUX.2 Klein 降低了 AI 绘画的本地部署门槛,8G 显存即可实现快速生成,支持图像编辑,适合个人创作及小型商用。

目录

  1. 前言
  2. 一、FLUX.2 Klein 特点
  3. 二、部署前准备
  4. 1. 硬件要求
  5. 2. 环境安装
  6. 1. 安装核心依赖
  7. 2. 安装图像工具
  8. 3. 安装 huggingface 工具
  9. 三、部署方案
  10. 方式 1:Python 脚本一键运行
  11. 步骤 1:创建运行脚本
  12. 1. 加载模型
  13. 2. 显存优化
  14. pipe.enablevaeslicing()
  15. 3. 生成图片
  16. 4. 保存并查看图片
  17. 步骤 2:运行脚本
  18. 方式 2:ComfyUI 可视化部署
  19. 步骤 1:安装 ComfyUI
  20. 步骤 2:下载模型
  21. 步骤 3:启动 ComfyUI
  22. 四、常见问题
  23. 1. 显存不足怎么办?
  24. 2. 模型下载慢/失败?
  25. 3. 生成效果不好?
  26. 五、总结

更多推荐文章

查看全部
  • Trae 配置 C++ 编译环境指南
  • 使用 Frontend Design Skill 提升大模型前端设计质量
  • Linux 命名管道(FIFO)通信:原理与跨进程实战
  • Python 列表内存存储机制:差异分析与优化策略
  • Top K 问题解决方案详解:堆排序、快排、Bitmap 与 Hash 分治
  • Whisper 模型怎么选:尺寸对比、下载地址和校验方法
  • DrissionPage 使用教程:Python 动态网页自动化实战
  • OpenClaw 飞书机器人配置指南:多渠道 AI 助手集成
  • OpenClaw gateway start 报 401 Invalid API key 环境变量配置问题
  • Pyglet:Python 游戏与多媒体开发入门
  • 上手 Llama 3:推理与 LoRA 微调实践
  • 微软 Copilot Cowork 解析:基于 Kotlin 构建 AI Agent
  • OpenAI 发布 GPT-5 系列:标准版、Mini 与 Nano 解析
  • Whisper v0.2 语音转文字工具安装与使用指南
  • DeerFlow 2.0:字节开源的超级 Agent 框架
  • 基于 uni-app 与 AI 辅助开发扫码点餐小程序
  • 使用 LLaMA-Factory 进行大语言模型微调详解
  • 前端开发一天通常能完成多少个页面?
  • 深入理解 Java 虚拟机 (JVM) 核心原理
  • IDEA/WebStorm 切换分支方法

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online