LibreAI / Image / Bagel
// image · ByteDance-Seed/Bagel

Bagel

ByteDance's open-source unified multimodal model for understanding, generation and image editing.

★ 6.2k stars⑂ 544 forksApache-2.0updated 2026-05
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Bagel is an open-source image project by ByteDance-Seed (ByteDance-Seed/Bagel on GitHub). It has 6,191 GitHub stars and 544 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 4 May 2026.

GitHub stars
6,191
Forks
544
License
Apache-2.0
Last updated on GitHub
4 May 2026
Category
Image
Listing
Full install guide
// how it works

How it works

  1. Clarify your multimodal goal

    Decide whether you need image understanding, text-to-image generation, image editing — or all three from one model.

  2. Clone and create the environment

    Clone the repo and create the documented Conda environment with Python 3.10.

  3. Install dependencies and weights

    Install the requirements and flash-attention, and download the BAGEL-7B-MoT weights from Hugging Face.

  4. Run the WebUI

    Launch the Gradio interface and run your first understanding, generation or editing task.

// features

Why people love it

Unified multimodal model

One model covers visual understanding, text-to-image generation and image editing instead of separate specialist models.

Mixture-of-Transformers design

The 7B MoT architecture routes understanding and generation through specialized transformer experts.

Gradio WebUI included

A ready Gradio app (also hosted as a Hugging Face Space) lets you try the model interactively.

Training and evaluation scripts

Ships training guidance (TRAIN.md) and evaluation scripts for VLM, text-to-image and editing benchmarks.

Tunable generation controls

Documented CFG controls for text and image guidance, denoising intervals and timestep shift let you balance fidelity and prompt adherence.

Community deployment options

Dockerfiles and community ComfyUI and quantized (INT8/DF11-compressed) variants are linked from the README.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone BAGEL (note the repository directory name) and enter it.

    git clone https://github.com/ByteDance-Seed/Bagel.git
    cd Bagel
  2. Set up the environment

    Create the Conda environment and install dependencies including flash-attention.

    conda create -n bagel python=3.10 -y
    conda activate bagel
    pip install -r requirements.txt
    pip install flash_attn==2.5.8 --no-build-isolation
  3. Launch the WebUI

    Download the BAGEL-7B-MoT weights from Hugging Face as the README directs, then start the Gradio WebUI to run inference.

    python app.py # see README for the exact command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains BAGEL?

BAGEL is developed by ByteDance-Seed, ByteDance's Seed research team.

Is BAGEL free?

The code is Apache-2.0 licensed and the model weights are published on Hugging Face; check the model card for the weights' terms.

Does it need a paid API key?

No — you download the weights and run inference locally on your own GPU.

How does it compare to Qwen2.5-VL or Janus-Pro?

Those focus mainly on understanding (or separate generation); BAGEL is designed as a single unified model for understanding, generation and editing, and the README publishes its benchmark comparisons.

How do I get started?

Clone the repo, create the Conda env, install requirements and flash-attention, download the weights, and launch the Gradio WebUI.

// keep exploring

Similar tools

Image

OmniGen

OmniGen: one unified model for text-to-image, editing, subject-driven and identity-preserving generation

★ 4.3k starsMIT
View guide →
Image

HunyuanImage-3.0

Tencent's HunyuanImage-3.0 — a powerful native multimodal model for image generation.

★ 3.3k starsNOASSERTION
View guide →
Image

pydantic-ai

How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end.

★ 20.4k starsMIT
View guide →
Image

Janus

DeepSeek's Janus series - unified multimodal models that both understand and generate images

★ 17.8k starsMIT
View guide →
Image

LLM-Hub

Run LLMs plus image, video and music generation locally on your phone

★ 603 starsCustom
View guide →
Image

mmagic

MMagic — OpenMMLab's generative-AI toolbox: diffusion, text-to-image, restoration and a model zoo.

★ 7.5k starsApache-2.0
View guide →
// alternatives

Alternatives in Image

The most-starred other Image projects in the LibreAI catalogue — the realistic shortlist if Bagel is not the right fit.

Get Bagel

Free and open — grab the source, star the repo, and start creating.