LibreAI / Image / flux
// image · black-forest-labs/flux

flux

Black Forest Labs' official inference repo for the FLUX.1 image generation models

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

Project facts

flux is an open-source image project by black-forest-labs (black-forest-labs/flux on GitHub). It has 26,009 GitHub stars and 1,925 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 31 July 2025.

GitHub stars
26,009
Forks
1,925
License
Apache-2.0
Last updated on GitHub
31 July 2025
Category
Image
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with flux and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Official FLUX.1 inference

The reference implementation from the model's creators for running FLUX.1 locally.

Open-weight model support

Covers the open-weight FLUX.1 variants with their individual licenses explained in the repo.

FLUX.1 Kontext examples

Includes examples for Kontext, the image editing/context model, including usage-tracking notes.

TensorRT option

A documented TensorRT installation path for NVIDIA performance setups.

API usage guidance

Explains when and how to use the hosted FLUX API instead of local weights.

Commercial licensing clarity

A dedicated section explains licensing the models for commercial use.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the official FLUX inference code.

    git clone https://github.com/black-forest-labs/flux.git
    cd flux
  2. Create a venv and install

    Use Python 3.10 and install the package with all extras, exactly as the README documents.

    python3.10 -m venv .venv
    source .venv/bin/activate
    pip install -e ".[all]"
  3. Run an example

    Download an open-weight model's weights as directed and run the README's example inference for that model.

    # see the README's model sections for the exact example command per model
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains flux?

flux is maintained by the black-forest-labs organization/account on GitHub, together with open-source contributors, in the public repository black-forest-labs/flux.

Is flux free to use?

Yes — the code is open source under the Apache-2.0 license. You can use, modify and redistribute it under that license's terms.

Does flux need a paid API key?

Local open-weight models need no API key (weights download from Hugging Face under each model's license); the hosted API and some models require an account and commercial licensing.

How does flux compare to Stable Diffusion (SDXL) tooling?

SDXL has a larger community ecosystem; FLUX.1 is chosen for its prompt fidelity and quality, with this repo as the vendor's reference implementation.

How do I get started with flux?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

Image

stable-diffusion.cpp

Diffusion model(SD,Flux,Wan,Qwen Image,Z-Image,...) inference in pure C/C++

★ 7.5k starsMIT
View guide →
Image

diffusers

🤗 Diffusers: State-of-the-art diffusion models for image, video, and audio generation in PyTorch.

★ 34.6k starsApache-2.0
View guide →
Image

aidea

An APP that integrates mainstream large language models and image generation models, built with Flutter, with fully open-source code.

★ 6.9k starsMIT
View guide →
Image

Bagel

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

★ 6.2k starsApache-2.0
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

pollinations-image-lab

Modern AI image lab on Pollinations.ai — models, seeds, history, transparency

★ 117 starsMIT
View guide →
// alternatives

Alternatives in Image

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

Get flux

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