跳到主要内容
极客日志极客日志面向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/9/3103 浏览
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. 五、总结

更多推荐文章

查看全部
  • JavaScript WebAPI 实战指南:DOM 操作与事件处理
  • 2024 年诺贝尔化学奖:AI 预测与人工设计蛋白质
  • C++ 迭代器全解析:从概念到实践
  • Manacher 算法详解:线性时间求解最长回文子串
  • 快速排序非递归实现详解:栈模拟与代码实战
  • Apache IoTDB 数据库管理:增删改查与异构数据库配置
  • 5 款开源 PPT 生成大模型实测对比
  • 大模型场景落地的关键技术与实践路径
  • Stable Diffusion 主流模型推荐与分类解析
  • Dify 接入企业微信群聊机器人详细步骤
  • 各行业垂直领域 AI 大模型资源汇总
  • 基于 SSM 和 Vue 的在线投稿系统设计与实现
  • 分治算法实战:归并排序与数组逆序对详解
  • Python 与 LangChain 集成通义千问构建聊天机器人
  • AI 大模型入门教程:从零开始掌握核心技术与应用
  • 渗透测试实战指南:核心流程与常见漏洞防御
  • 深入理解 SPA:单页面应用的优缺点
  • ELF Hash 算法原理及 C++ 实现解析
  • 解决 Java 编译报错:源发行版 17 需要目标发行版 17
  • STL map 与 multimap 深度解析:接口、特性与实战应用

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如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