53
stars
32
commits
1
repos using this model
11
linked in READMEs
Jul 24, 2026
updated
⚠️ Important Notice
The Boogu team does NOT currently provide any paid API, subscription, or commercial service for Boogu-Image. Any paid product or service offered under the name "Boogu-Image" — or any similar / variant name such as
booguimage,Boogu Image,Boogu, etc. — is NOT affiliated with this project and is unofficial. Please verify carefully before making any payment, and stay vigilant to protect your personal privacy and financial safety.Boogu-Image-0.1 is a research project only, and not an official model release.
Boogu-Image-0.1 is a competitive Apache-2.0 open-source unified image generation and editing model family, including Base, Turbo, Edit, and Edit-Turbo, and other variants that provide stable, practical capabilities for high-quality text-to-image generation, fast generation, image editing, and Chinese-English text rendering. Closed-source multimodal understanding and generation systems like Nano Banana Pro and GPT-Image-2 achieve remarkable performance not because of a single model, but through a highly unified suite of system capabilities. However, under training compute that is extremely limited compared with closed-source systems, we find that systematically improving a model's understanding ability, data quality, and training pipeline can still significantly improve image generation and editing performance. Specifically, compared with some existing open-source models, our training data scale is roughly one order of magnitude smaller. We hope our empirical study and open-source release will help advance the open-source ecosystem for multimodal generation and understanding.
This repository provides checkpoints and inference code for Boogu-Image-0.1.
npu branch for initial NPU backend support and instructions. We welcome feedback and bug reports!Boogu-Image is built to grow with its users. Share what you create, report issues, exchange ideas, and help shape what comes next.
WeChat Group
Since we could not evaluate on LM Arena directly, we built Boogu Arena, an LM Arena-style preference evaluation. We use an LLM to generate diverse user personas, then ask each persona to produce image generation prompts, resulting in 1K+ test prompts that we will release publicly for community reproduction. The ELO leaderboard below spans leading closed- and open-source systems. We welcome teams with questions about the results to contact us so that we can work toward a more objective, fair, and reproducible evaluation.






📖 For the full set of practical lessons and an honest account of current limitations, see Responsible AI & Limitations below.
Beyond overall arena rankings, we break performance down by scenario across leading open-source peers. Ratings reflect our internal evaluation of typical prompts in each category.
| Model | Realistic Photography | Simple Text Rendering | Dense Text Rendering |
|---|---|---|---|
| Boogu-Image-0.1-Turbo | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| Boogu-Image-0.1-Base | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| Z-Image-Turbo | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| Qwen-Image-2512 | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
Unless otherwise specified, all model variants support the following aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 1:2, 2:1, 9:16, and 16:9.
Tested environment: Python 3.10 · CUDA 12.6 · PyTorch 2.7.1
# Use a brand new conda environment
conda create -y -n boogu python=3.10
conda activate boogu
# Instal necessary dependencies
# PyTorch up to 2.11.0 with CUDA up to 12.8 is supported
# Check `requirements/<torch>_<cuda>.txt`
pip install -r requirements/torch2.7-cu126.txt
pip install -e .
python utils/get_flash_attn.py
or
bash quick_start.sh
conda activate boogu
Download the model weights into a local models/ directory before running inference. We recommend using the official Hugging Face CLI:
pip install -U "huggingface_hub[cli]"
# Download to ./models/<model-name>
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
huggingface-cli download Boogu/Boogu-Image-0.1-Edit-Turbo --local-dir models/Boogu-Image-0.1-Edit-Turbo
Example layout after download:
models/
└── Boogu-Image-0.1-Base/
├── model_index.json
├── mllm
├── processor
├── scheduler
├── transformer
└── vae
Then point inference to the local path via --model models/Boogu-Image-0.1-Base.
This repository provides utils/get_flash_attn.py to automatically install a compatible flash-attn wheel for your environment.
Requirements:
# Auto: detect environment, download a prebuilt wheel, fallback to source build
python utils/get_flash_attn.py
# Force source compilation
python utils/get_flash_attn.py --build
The script first searches mjun0812/flash-attention-prebuild-wheels, then tries official Dao-AILab/flash-attention release wheels with both cxx11abi variants, and finally falls back to source compilation via pip install flash-attn --no-build-isolation.
export PYTHONPATH="$PWD:${PYTHONPATH:-}"
export device="cuda:0"
mkdir -p outputs/test_ti2i_turbo/
python inference_turbo.py \
--pretrained_pipeline_name_or_path "models/Boogu-Image-0.1-Edit-Turbo" \
--input_image_paths "input_image_examples/03.jpg" \
--instruction "把背景替换到沙滩." \
--dmd_conditioning_sigma 0.0 \
--output_image_path "outputs/test_ti2i_turbo/out_1.png" \
--device "$device"
For Ascend NPU inference support, please switch to the npu branch:
git checkout npu
Follow the instructions in the README.md on that branch for setup and usage details.
📖 For full CLI options, device setup, offload strategies, caching acceleration, Torch Compile, FP8, and batch inference details, see INFERENCE_GUIDE.md. Torch Compile note:
--enable_torch_compilecan occasionally produce all-black outputs on some GPUs/models. If that happens, disable it first.
| VRAM | Recommended Config (T2I 1K) | Recommended Config (T2I 2K) |
|---|---|---|
| 12GB | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_model_cpu_offload_flag --use_fp8_weights | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_group_offload_flag --use_fp8_weights |
| 16GB | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_model_cpu_offload_flag --use_fp8_weights | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_model_cpu_offload_flag --use_fp8_weights |
| 24GB | Unquantized: --enable_model_cpu_offload_flagQuantized --use_fp8_weights | --enable_model_cpu_offload_flag |
| 32GB | Unquantized: --enable_model_cpu_offload_flagQuantized: --use_fp8_weights | Unquantized: --enable_model_cpu_offload_flagQuantized: --use_fp8_weights |
| 40GB | Base Model | Unquantized: --enable_model_cpu_offload_flagQuantized: --use_fp8_weights |
| 80GB | Base Model | Base Model |
Boogu-Image-0.1 is released for research purposes and is not intended for production deployment without additional safeguards. We took responsible-AI considerations into account during data curation, training, and evaluation; however the model may still produce outputs that are inaccurate, biased, or otherwise inappropriate.
🌍 World Knowledge Gap
🖼️ Image-to-Image Consistency & In-Context Scenarios
📝 Text Rendering Stability
🦴 Body Structure in Complex Poses
👤 Small Faces & Small Limbs
📦 Limited Release Scope
Downstream users are responsible for applying content moderation, validation, and compliance checks appropriate to their use case.
Closed-source systems such as GPT-Image, Nano Banana, and the Seedream series helped us understand the frontier capabilities and practical boundaries of unified understanding-and-generation systems. We thank the Qwen-Image, Z-Image, OmniGen2, FLUX, Lumina-Image-2.0 and broader open-source communities for the foundations they provide, and DeepSeek for strong open-source understanding models that support open-source unified multimodal systems.
@misc{chen2026booguimage01,
title={Boogu-Image-0.1: Boosting Open Agentic Multimodal Generation via Understanding under a Minimal Budget},
author={Guoxuan Chen and Chufeng Xiao and Haoran Yang and Siyue Xie and Binxiao Huang and Ming Zhang and Cheuk Him Chau and Xinyu Fu and Yingzhao Lian and Tom S. Y. Li and Jintao Lin and Bowen Dong and Zian Qian and Yuhao Liu and Yuxuan Hu and Weikang Shi and Bin Zou and Bowen Zheng and Haoxuan Che and Chang Chen and Yuyang He and Heyang Sun and Tianyu Huang and Chong Hou Choi and Cheng Gong and Han Shi and Haoli Bai and Xihui Liu and Hongsheng Li and Qifeng Chen and Chao Huang and Rui Liu and Chenyang Lei},
year={2026},
eprint={2607.13125},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2607.13125},
}
This project is released under the Apache-2.0 License.
53
stars
32
commits
1
repos using this model
11
linked in READMEs
Jul 24, 2026
updated
⚠️ Important Notice
The Boogu team does NOT currently provide any paid API, subscription, or commercial service for Boogu-Image. Any paid product or service offered under the name "Boogu-Image" — or any similar / variant name such as
booguimage,Boogu Image,Boogu, etc. — is NOT affiliated with this project and is unofficial. Please verify carefully before making any payment, and stay vigilant to protect your personal privacy and financial safety.Boogu-Image-0.1 is a research project only, and not an official model release.
Boogu-Image-0.1 is a competitive Apache-2.0 open-source unified image generation and editing model family, including Base, Turbo, Edit, and Edit-Turbo, and other variants that provide stable, practical capabilities for high-quality text-to-image generation, fast generation, image editing, and Chinese-English text rendering. Closed-source multimodal understanding and generation systems like Nano Banana Pro and GPT-Image-2 achieve remarkable performance not because of a single model, but through a highly unified suite of system capabilities. However, under training compute that is extremely limited compared with closed-source systems, we find that systematically improving a model's understanding ability, data quality, and training pipeline can still significantly improve image generation and editing performance. Specifically, compared with some existing open-source models, our training data scale is roughly one order of magnitude smaller. We hope our empirical study and open-source release will help advance the open-source ecosystem for multimodal generation and understanding.
This repository provides checkpoints and inference code for Boogu-Image-0.1.
npu branch for initial NPU backend support and instructions. We welcome feedback and bug reports!Boogu-Image is built to grow with its users. Share what you create, report issues, exchange ideas, and help shape what comes next.
WeChat Group
Since we could not evaluate on LM Arena directly, we built Boogu Arena, an LM Arena-style preference evaluation. We use an LLM to generate diverse user personas, then ask each persona to produce image generation prompts, resulting in 1K+ test prompts that we will release publicly for community reproduction. The ELO leaderboard below spans leading closed- and open-source systems. We welcome teams with questions about the results to contact us so that we can work toward a more objective, fair, and reproducible evaluation.






📖 For the full set of practical lessons and an honest account of current limitations, see Responsible AI & Limitations below.
Beyond overall arena rankings, we break performance down by scenario across leading open-source peers. Ratings reflect our internal evaluation of typical prompts in each category.
| Model | Realistic Photography | Simple Text Rendering | Dense Text Rendering |
|---|---|---|---|
| Boogu-Image-0.1-Turbo | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| Boogu-Image-0.1-Base | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| Z-Image-Turbo | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| Qwen-Image-2512 | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
Unless otherwise specified, all model variants support the following aspect ratios: 1:1, 2:3, 3:2, 3:4, 4:3, 1:2, 2:1, 9:16, and 16:9.
Tested environment: Python 3.10 · CUDA 12.6 · PyTorch 2.7.1
# Use a brand new conda environment
conda create -y -n boogu python=3.10
conda activate boogu
# Instal necessary dependencies
# PyTorch up to 2.11.0 with CUDA up to 12.8 is supported
# Check `requirements/<torch>_<cuda>.txt`
pip install -r requirements/torch2.7-cu126.txt
pip install -e .
python utils/get_flash_attn.py
or
bash quick_start.sh
conda activate boogu
Download the model weights into a local models/ directory before running inference. We recommend using the official Hugging Face CLI:
pip install -U "huggingface_hub[cli]"
# Download to ./models/<model-name>
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
huggingface-cli download Boogu/Boogu-Image-0.1-Edit-Turbo --local-dir models/Boogu-Image-0.1-Edit-Turbo
Example layout after download:
models/
└── Boogu-Image-0.1-Base/
├── model_index.json
├── mllm
├── processor
├── scheduler
├── transformer
└── vae
Then point inference to the local path via --model models/Boogu-Image-0.1-Base.
This repository provides utils/get_flash_attn.py to automatically install a compatible flash-attn wheel for your environment.
Requirements:
# Auto: detect environment, download a prebuilt wheel, fallback to source build
python utils/get_flash_attn.py
# Force source compilation
python utils/get_flash_attn.py --build
The script first searches mjun0812/flash-attention-prebuild-wheels, then tries official Dao-AILab/flash-attention release wheels with both cxx11abi variants, and finally falls back to source compilation via pip install flash-attn --no-build-isolation.
export PYTHONPATH="$PWD:${PYTHONPATH:-}"
export device="cuda:0"
mkdir -p outputs/test_ti2i_turbo/
python inference_turbo.py \
--pretrained_pipeline_name_or_path "models/Boogu-Image-0.1-Edit-Turbo" \
--input_image_paths "input_image_examples/03.jpg" \
--instruction "把背景替换到沙滩." \
--dmd_conditioning_sigma 0.0 \
--output_image_path "outputs/test_ti2i_turbo/out_1.png" \
--device "$device"
For Ascend NPU inference support, please switch to the npu branch:
git checkout npu
Follow the instructions in the README.md on that branch for setup and usage details.
📖 For full CLI options, device setup, offload strategies, caching acceleration, Torch Compile, FP8, and batch inference details, see INFERENCE_GUIDE.md. Torch Compile note:
--enable_torch_compilecan occasionally produce all-black outputs on some GPUs/models. If that happens, disable it first.
| VRAM | Recommended Config (T2I 1K) | Recommended Config (T2I 2K) |
|---|---|---|
| 12GB | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_model_cpu_offload_flag --use_fp8_weights | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_group_offload_flag --use_fp8_weights |
| 16GB | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_model_cpu_offload_flag --use_fp8_weights | Unquantized: --enable_sequential_cpu_offload_flagQuantized: --enable_model_cpu_offload_flag --use_fp8_weights |
| 24GB | Unquantized: --enable_model_cpu_offload_flagQuantized --use_fp8_weights | --enable_model_cpu_offload_flag |
| 32GB | Unquantized: --enable_model_cpu_offload_flagQuantized: --use_fp8_weights | Unquantized: --enable_model_cpu_offload_flagQuantized: --use_fp8_weights |
| 40GB | Base Model | Unquantized: --enable_model_cpu_offload_flagQuantized: --use_fp8_weights |
| 80GB | Base Model | Base Model |
Boogu-Image-0.1 is released for research purposes and is not intended for production deployment without additional safeguards. We took responsible-AI considerations into account during data curation, training, and evaluation; however the model may still produce outputs that are inaccurate, biased, or otherwise inappropriate.
🌍 World Knowledge Gap
🖼️ Image-to-Image Consistency & In-Context Scenarios
📝 Text Rendering Stability
🦴 Body Structure in Complex Poses
👤 Small Faces & Small Limbs
📦 Limited Release Scope
Downstream users are responsible for applying content moderation, validation, and compliance checks appropriate to their use case.
Closed-source systems such as GPT-Image, Nano Banana, and the Seedream series helped us understand the frontier capabilities and practical boundaries of unified understanding-and-generation systems. We thank the Qwen-Image, Z-Image, OmniGen2, FLUX, Lumina-Image-2.0 and broader open-source communities for the foundations they provide, and DeepSeek for strong open-source understanding models that support open-source unified multimodal systems.
@misc{chen2026booguimage01,
title={Boogu-Image-0.1: Boosting Open Agentic Multimodal Generation via Understanding under a Minimal Budget},
author={Guoxuan Chen and Chufeng Xiao and Haoran Yang and Siyue Xie and Binxiao Huang and Ming Zhang and Cheuk Him Chau and Xinyu Fu and Yingzhao Lian and Tom S. Y. Li and Jintao Lin and Bowen Dong and Zian Qian and Yuhao Liu and Yuxuan Hu and Weikang Shi and Bin Zou and Bowen Zheng and Haoxuan Che and Chang Chen and Yuyang He and Heyang Sun and Tianyu Huang and Chong Hou Choi and Cheng Gong and Han Shi and Haoli Bai and Xihui Liu and Hongsheng Li and Qifeng Chen and Chao Huang and Rui Liu and Chenyang Lei},
year={2026},
eprint={2607.13125},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2607.13125},
}
This project is released under the Apache-2.0 License.