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

更多推荐文章

查看全部
  • 2024 年边缘人工智能现状与大模型开发技术指南
  • JavaScript 中 window.location 对象详解与实战
  • YApi 接口管理:自动生成前端请求函数实战
  • 如何轻松将代码上传至 Gitee?Git 实战指南
  • OpenClaw 与 Claude Code、Cursor、Copilot 的区别
  • Pinokio:本地 AI 工具的一站式安装与管理方案
  • Copilot 实战:如何高效完成 1.5 万行 Python 项目(含提示词模板)
  • 基于大模型 API 构建本地化个人 AI 助理
  • 动态规划专题:子序列问题的核心思路与实战
  • 双指针处理数组:移动零与复写零
  • 网络安全自学指南:零基础入门与学习路线
  • AI 大模型的崛起、应用及未来影响分析
  • HarmonyOS 开发:从零实现加载和使用自定义字体
  • Web 开发者基于 Dify 构建 AI Agent 招聘系统
  • AI 智能体 Claude Code 从部署到项目实战详解
  • Whisper-large-v3 本地部署与语音识别实战
  • Llama-Factory 集成 Wandb 监控:跨团队训练协作
  • 动态规划:最长递增子序列变体解析
  • JavaScript 内置对象实战:String、Number 与 Array
  • 安卓系统Chrome内核:Android System WebView

相关免费在线工具

  • 加密/解密文本

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