如何快速上手 Boogu-Image:从环境安装到第一张AI生成图的完整教程
人工智能基础模型媒体生成计算机视觉【免费下载链接】Boogu-ImageBoogu-Image-0.1 is an Apache-2.0 open-source image generation and editing model family that delivers near-closed-source performance with an order of magnitude less data.项目地址https://gitcode.com/gh_mirrors/bo/Boogu-Image点击查看免费下载Boogu-Image 是一个采用 Apache-2.0 协议开源的AI 图像生成与编辑模型家族支持文生图T2I、图生图编辑TI2I、中英双语文本渲染并提供只需 4 步的极速生成版本。本教程将带你从零开始完成 Boogu-Image 环境安装、模型权重下载并亲手跑出你的第一张 AI 生成图。 Boogu-Image 是什么四大模型变体一览Boogu-Image-0.1 由四个变体组成覆盖从精细可控到极速出图的不同场景模型推理步数适用任务特点Boogu-Image-0.1-Base25~50 步文生图T2I多样性强、可控性高擅长密集文本渲染支持 1K/1.5K/2KBoogu-Image-0.1-Turbo4 步文生图T2I蒸馏加速版照片级真实感默认首选Boogu-Image-0.1-Edit25~50 步图生图TI2I插入/替换/删除物体、换背景、风格迁移Boogu-Image-0.1-Edit-Turbo4 步图生图TI2I编辑任务的极速版本官方在自建的 Boogu Arena 评测中该系列模型综合排名位居已评测的开闭源系统前列。它的核心能力包括真实感摄影光影自然、构图合理、细节忠实稳定文本渲染海报、印章、文档、界面等中英双语排版多样风格化迷你 3D、国风流金、动漫人像等创意生成️全能图像编辑物体增删改、材质修改、背景替换、风格迁移 新手建议先装Base模型熟悉流程之后按需补装Turbo要速度或Edit要编辑。 第一步一条命令安装 Boogu-Image 环境Boogu-Image 已在Python 3.10 CUDA 12.6 PyTorch 2.7.1环境下完成验证也支持最高 PyTorch 2.11 / CUDA 12.8见 requirements/ 目录下各版本依赖清单如 requirements/torch2.7-cu126.txt。方式一使用一键脚本推荐新手# 克隆代码仓库 git clone https://gitcode.com/gh_mirrors/bo/Boogu-Image cd Boogu-Image # 一键创建 conda 环境、安装依赖、安装 flash-attn bash quick_start.sh conda activate booguquick_start.sh 会自动完成创建boogu环境Python 3.10、安装依赖、执行pip install -e .并自动安装匹配的 utils/get_flash_attn.py Flash Attention 加速库。方式二手动安装conda create -y -n boogu python3.10 conda activate boogu pip install -r requirements/torch2.7-cu126.txt pip install -e . python utils/get_flash_attn.py 第二步下载 Boogu-Image 模型权重使用 Hugging Face CLI 将模型下载到本地models/目录pip install -U huggingface_hub[cli] # 按需下载新手先下 Base 即可 huggingface-cli download Boogu/Boogu-Image-0.1-Base --local-dir models/Boogu-Image-0.1-Base huggingface-cli download Boogu/Boogu-Image-0.1-Turbo --local-dir models/Boogu-Image-0.1-Turbo huggingface-cli download Boogu/Boogu-Image-0.1-Edit --local-dir models/Boogu-Image-0.1-Edit下载完成后目录结构如下推理时通过--pretrained_pipeline_name_or_path指向该路径models/ └── Boogu-Image-0.1-Base/ ├── model_index.json ├── mllm ├── processor ├── scheduler ├── transformer └── vae 第三步运行第一张 AI 生成图T2IBoogu-Image 的推理入口是 inference.py。执行前必须先设置device环境变量部分模块会读取该变量决定是否启用 GPU 加速算子再运行export devicecuda:0 # 必填 python inference.py \ --pretrained_pipeline_name_or_path models/Boogu-Image-0.1-Base \ --instruction 一幅国风琉金风格的山水画作远山层叠江水如镜山峰边缘勾勒着发光的金色线条画面梦幻朦胧而又磅礴大气。 \ --num_inference_steps 50 \ --height 1024 --width 1024 \ --text_guidance_scale 4.0 \ --output_image_path outputs/test_base/out_1.png \ --device $device几个新手必知要点--instruction提示词支持中文写得越具体效果越好主体、场景、风格、光影--num_inference_stepsBase 模型推荐 25~50 步Turbo 模型固定用 4 步同时把--text_guidance_scale设为 1.0--height/--width输出尺寸内部会自动对齐到 16 的倍数支持 1:1、16:9、9:16 等多种比例--output_image_path结果保存路径记得提前建好父目录⚡ 如果不想记参数直接复制 demo_scripts/demo_t2i.sh 改一改就能跑demo_scripts/ 目录还预置了批量推理、低显存、提示词改写等 30 多个示例脚本。纯 Python 集成方式可参考 inference_simple.py。️ 第四步体验 AI 图像编辑TI2I切换到 Edit 模型加上--input_image_paths参考图参数即可进行图像编辑。仓库自带示例图 input_image_examples/ 可以直接拿来练手export devicecuda:0 python inference.py \ --pretrained_pipeline_name_or_path models/Boogu-Image-0.1-Edit \ --instruction 把图中的红色汽车变成蓝色汽车其余保持不变。 \ --input_image_paths input_image_examples/02.png \ --num_inference_steps 50 \ --text_guidance_scale 5.0 \ --output_image_path outputs/test_edit/out_1.png \ --device $device完整参数可对照 demo_scripts/demo_ti2i.sh。除了物体增删改Edit 模型还擅长海报设计和精准文字编辑——比如生成带中英标题的海报、替换图中指定文字 显存不够按需选择 Offload 策略Base 模型无 offload 直接跑约需40GB 显存显存有限时可以启用三种互斥的 offload 开关三选一详见 INFERENCE_GUIDE.md显存T2I 1K 推荐配置12~16GB--enable_sequential_cpu_offload_flag True显存占用 2GB最慢24~32GB--enable_model_cpu_offload_flag True显存约 22GB均衡之选40~80GB无需 offload直接跑# 12GB 显卡低显存示例 python inference.py \ --pretrained_pipeline_name_or_path models/Boogu-Image-0.1-Base \ --instruction 一只在雪地里奔跑的哈士奇电影感光影 \ --height 1024 --width 1024 \ --num_inference_steps 50 --text_guidance_scale 4.0 \ --output_image_path outputs/low_mem/out_1.png \ --device $device \ --rewriter_device $device \ --enable_sequential_cpu_offload_flag True \ --enable_model_cpu_offload_flag False \ --enable_group_offload_flag False⚠️ 注意启用任何 offload 时device必须为cuda/cuda:x不支持 CPU 设备。 进阶加速与核心文件速查想进一步提速或省显存可以了解这些可选开关TeaCache / TaylorSeer / Cache-DiTTransformer 缓存加速按需开启建议先关缓存跑通基线再逐个开启优先级为 Cache-DiT TaylorSeer TeaCache--use_fp8_weightsFP8 量化权重加载可显著降低显存需先用 utils/quantize_transformer.py 预量化--enable_torch_compile编译加速若出现全黑图请关闭提示词改写--use_rewrite_text_instruction True可让指令理解器自动润色你的提示词核心文件导航文件说明inference.py主推理入口T2I / TI2I / 批量INFERENCE_GUIDE.md完整参数手册与兼容性矩阵demo_scripts/30 开箱即用的示例脚本boogu/pipelines/boogu/pipeline_boogu.py核心推理管线源码utils/get_flash_attn.pyFlash Attention 自动安装脚本✅ 常见问题排查FAQ提示device相关报错确认已export devicecuda:0且传了--device $device两者必须一致生成速度太慢换用 Turbo 模型4 步出图或开启 TeaCache显存溢出OOM按上文表格启用 offload或改用 FP8 量化版输出全黑先检查是否启用了--enable_torch_compile关闭后重试结果偏模糊检查--max_input_image_pixels是否与目标分辨率匹配设置过低会先生成低分辨率图再放大恭喜到这里你已经走完了 Boogu-Image 的完整上手路径环境安装 → 权重下载 → 第一张 AI 生成图 → 图像编辑 → 显存优化。接下来可以试试 demo_scripts/ 里的批量推理脚本或深入 INFERENCE_GUIDE.md 探索更多高级参数祝你创作愉快 赞分享人工智能基础模型媒体生成计算机视觉【免费下载链接】Boogu-ImageBoogu-Image-0.1 is an Apache-2.0 open-source image generation and editing model family that delivers near-closed-source performance with an order of magnitude less data.项目地址https://gitcode.com/gh_mirrors/bo/Boogu-Image点击查看免费下载相关推荐Qwen-Image-2.1快速上手教程10分钟从环境配置到第一张2K AI绘图Qwen Image 2.1快速上手教程10分钟从环境配置到第一张2K AI绘图 Qwen Image 2.1 是通义千问Qwen家族中最强大的开源图像生人工智能大模型基础模型媒体生成多模态提示工程本地部署Ming-Image-0.1-Design-4bit快速上手教程5分钟从安装到生成第一张AI设计图附Swift示例Ming Image 0.1 Design 4bit快速上手教程5分钟从安装到生成第一张AI设计图附Swift示例 Ming Image 0.1 DesiQwen-Image-2.1-mflux-q4快速上手从下载到生成第一张1024x1024 AI图像Qwen Image 2.1 mflux q4快速上手从下载到生成第一张1024x1024 AI图像 Qwen Image 2.1 mflux q4 是 Qw创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

解码开销小于0.5%是怎么做到的?Qwen3.5-9B-singprobe内生护栏原理深度剖析

解码开销小于0.5%是怎么做到的?Qwen3.5-9B-singprobe内生护栏原理深度剖析

【免费下载链接】Qwen3.5-9B-singprobe 项目地址: https://ai.gitcode.com/hf_mirrors/inclusionAI/Qwen3.5-9B-singprobe 点击查看 免费下载 Qwen3.5-9B-singprobe 是一个基于 Qwen3.5-9B 大模型的"内生式"流式安全护栏探针,它在模型逐 toke…

2026/10/17 21:52:54 阅读更多 →
3步在本地跑起文生视频:Wan2.1-T2V-1.3B-GGUF快速上手教程(huggingface-cli完整演示)

3步在本地跑起文生视频:Wan2.1-T2V-1.3B-GGUF快速上手教程(huggingface-cli完整演示)

【免费下载链接】Wan2.1-T2V-1.3B-GGUF 项目地址: https://ai.gitcode.com/hf_mirrors/samuelchristlie/Wan2.1-T2V-1.3B-GGUF 点击查看 免费下载 Wan2.1-T2V-1.3B-GGUF 是一个把阿里 Wan2.1 开源文生视频(Text-to-Video)模型直接转换为 GGU…

2026/10/17 21:52:54 阅读更多 →
C++23模式匹配:类型安全的业务逻辑重构利器

C++23模式匹配:类型安全的业务逻辑重构利器

简介:本资源是一份面向C中高级开发者的技术深度解析文档,聚焦C23新引入的模式匹配特性,系统解决业务逻辑重构复杂、类型安全难以保障、多态与变体处理冗余等实际工程痛点。文档覆盖核心语法、六大实战场景(状态机/条件判断/嵌套结…

2026/10/17 21:51:53 阅读更多 →

最新新闻

主从博弈下综合能源微网需求响应优化调度模型全解析

主从博弈下综合能源微网需求响应优化调度模型全解析

第一次看到“基于主从博弈的综合能源微网需求响应优化调度模型”这个题目,很多人会把它当成一个普通的优化调度问题来读:目标函数、约束条件、求解器一跑,出结果就完事了。但我实际调过这类模型之后发现,真正难的不是数学工具&…

2026/10/18 4:40:33 阅读更多 →
PyTorch Unet图像分割实战:DUT-OMRON数据集端到端训练与推理

PyTorch Unet图像分割实战:DUT-OMRON数据集端到端训练与推理

简介:本资源是一套面向深度学习初学者与图像分割实践者的Unet多尺度分割实战项目,聚焦二值图像分割任务,特别适用于学术研究、课程设计及算法复现场景。资源包含完整的DUT-OMRON数据集(训练集4135对images/masks、测试集1033对&am…

2026/10/18 4:40:33 阅读更多 →
信创监控实战:国产数据库与中间件指标采集及告警体系设计

信创监控实战:国产数据库与中间件指标采集及告警体系设计

1. 信创监控的痛点与整体架构设计1.1 为什么信创环境的监控不能照搬旧方案之前负责的某业务系统做信创替换,数据库从国外商业数据库换成某国产关系型数据库,中间件也换成了国产Web中间件。系统切过去第一天,监控大屏上将近一半的指标直接变成…

2026/10/18 4:40:33 阅读更多 →
推荐系统离线评估指标详解:准确率、召回率、F1与NDCG

推荐系统离线评估指标详解:准确率、召回率、F1与NDCG

做推荐系统,迟早要面对一个问题:我怎么量化推荐质量。业务方问一句“这次模型效果到底提升了没”,如果只丢出一句“感觉差不多”,那接下来的优化根本没法推进。准确率、召回率、F1、NDCG,这四个词就是推荐系统离线评估…

2026/10/18 4:40:33 阅读更多 →
schooldb代码实战:MySQL学生选课系统数据库设计全解析

schooldb代码实战:MySQL学生选课系统数据库设计全解析

搜“schooldb代码”的人,十有八九都是同一类需求:要么是数据库课设不知道从哪下手,要么是公司里突然要接一个校园管理相关的数据层,想找个偏教学向、能直接跑的库来抄作业。这个方向我帮不少人做过参考,也接过不少来问…

2026/10/18 4:40:33 阅读更多 →
学习打卡功能开发实战:从表结构设计到线上踩坑全记录

学习打卡功能开发实战:从表结构设计到线上踩坑全记录

前段时间接了一个学习类App的项目,需求池里躺着一个编号3.10的任务,名字就四个字:学习打卡。当时团队里不少人都觉得,这不就是给用户一个按钮,每天点一下签个到吗?结果真进入开发阶段才发现,这个…

2026/10/18 4:39:33 阅读更多 →

日新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型(GMM)的语音识别系统,很多人第一反应就是一堆数学公式,觉得门槛很高。但如果你真的在MATLAB里把它落地跑通,会发现核心其实就是三件事:把声音变成特征向量,用GMM给每个类别…

2026/10/18 0:00:55 阅读更多 →
数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人,但落到具体操作上,无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程:对图像做反白、改调色板、彩色转灰度,最后把像素数据导出成txt文件。单看每一…

2026/10/18 0:00:55 阅读更多 →
机器人大脑技术盘点:具身智能的感知、决策与数据闭环

机器人大脑技术盘点:具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词,你会发现一个很有意思的现象:每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型,有人指的是运动控制系统,还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/18 0:00:55 阅读更多 →

周新闻

基于GMM的语音识别系统原理与MATLAB实现详解

基于GMM的语音识别系统原理与MATLAB实现详解

说到基于高斯混合模型(GMM)的语音识别系统,很多人第一反应就是一堆数学公式,觉得门槛很高。但如果你真的在MATLAB里把它落地跑通,会发现核心其实就是三件事:把声音变成特征向量,用GMM给每个类别…

2026/10/18 0:00:55 阅读更多 →
数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理入门:反白、灰度化、调色板修改与导出txt实践

数字图像处理这四个字听起来挺唬人,但落到具体操作上,无非就是让计算机按你的想法“摆弄”像素。我在一个模拟项目X里用了一套特别经典的基础处理流程:对图像做反白、改调色板、彩色转灰度,最后把像素数据导出成txt文件。单看每一…

2026/10/18 0:00:55 阅读更多 →
机器人大脑技术盘点:具身智能的感知、决策与数据闭环

机器人大脑技术盘点:具身智能的感知、决策与数据闭环

如果你的信息流最近也天天刷到“机器人大脑”这个词,你会发现一个很有意思的现象:每个人说的“大脑”根本不是同一个东西。有人指的是大语言模型,有人指的是运动控制系统,还有人指的是能理解物理世界的端到端模型。在2026年这个时…

2026/10/18 0:00:55 阅读更多 →

月新闻

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路:用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/18 0:55:02 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式:TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/17 17:22:31 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/16 14:23:36 阅读更多 →