How black-forest-labs/flux works
FLUX is a Python reference runtime for generating and editing images with open-weight models. Users invoke a command-line mode, provide text and—depending on the mode—an image, mask, or structural condition; the runtime prepares conditioning, samples the Flux model, decodes latents, and saves results. The README documents text-to-image, fill, structural conditioning, Redux variation, and Kontext editing. TensorRT is an optional inference backend. Relationships are limited to those shown in the README and supplied source references; unsampled implementation details are not inferred.
Main entry points: sampling.py Sampling pipeline · __main__.py Mode dispatch · util.py Model and image utilities · cli_kontext.py Kontext editing
Components 22
CLI modes
- Mode dispatch
src/flux/__main__.py - Text generation
src/flux/cli.py - Structural control
src/flux/cli_control.py - Fill editing
src/flux/cli_fill.py - Kontext editing
src/flux/cli_kontext.py - Redux variation
src/flux/cli_redux.py
Inputs and conditioning
- Text encoders
src/flux/modules/conditioner.py - Image encoders
src/flux/modules/image_embedders.py
Model inference
- Sampling pipeline
src/flux/sampling.py - Autoencoder
src/flux/modules/autoencoder.py - Flux transformer
src/flux/model.py - Transformer layers
src/flux/modules/layers.py - Attention math
src/flux/math.py - LoRA support
src/flux/modules/lora.py
Results and utilities
- Content filters
src/flux/content_filters.py - Model and image utilities
src/flux/util.py
TensorRT backend
- Engine manager
src/flux/trt/trt_manager.py - Engine configs
src/flux/trt/trt_config - Engine runtime
src/flux/trt/engine/base_engine.py - Transformer engine
src/flux/trt/engine/transformer_engine.py - VAE engines
src/flux/trt/engine/vae_engine.py
Other components
- User
Connections 32
- User → Mode dispatch: invokes
src/flux/__main__.py - Mode dispatch → Text generation: dispatches
src/flux/__main__.py - Mode dispatch → Structural control: dispatches
src/flux/__main__.py - Mode dispatch → Fill editing: dispatches
src/flux/__main__.py - Mode dispatch → Kontext editing: dispatches
src/flux/__main__.py - Mode dispatch → Redux variation: dispatches
src/flux/__main__.py - Text generation → Sampling pipeline: calls
src/flux/cli.py - Structural control → Sampling pipeline: calls
src/flux/cli_control.py - Fill editing → Sampling pipeline: calls
src/flux/cli_fill.py - Kontext editing → Sampling pipeline: calls
src/flux/cli_kontext.py - Redux variation → Sampling pipeline: calls
src/flux/cli_redux.py - Sampling pipeline → Text encoders: encodes prompts
src/flux/sampling.py - Sampling pipeline → Image encoders: encodes images
src/flux/sampling.py - Sampling pipeline → Autoencoder: encodes and decodes
src/flux/sampling.py - Sampling pipeline → Flux transformer: denoises with
src/flux/sampling.py - Sampling pipeline → Model and image utilities: uses utilities
src/flux/sampling.py - Flux transformer → Transformer layers: uses layers
src/flux/model.py - Flux transformer → LoRA support: uses LoRA
src/flux/model.py - Transformer layers → Attention math: uses attention math
src/flux/modules/layers.py - Text generation → Model and image utilities: loads and saves
src/flux/cli.py - Structural control → Model and image utilities: uses utilities
src/flux/cli_control.py - Fill editing → Model and image utilities: uses utilities
src/flux/cli_fill.py - Kontext editing → Model and image utilities: uses utilities
src/flux/cli_kontext.py - Kontext editing → Content filters: uses filters
src/flux/cli_kontext.py - Redux variation → Model and image utilities: uses utilities
src/flux/cli_redux.py - Text generation → Engine manager: loads engines
src/flux/cli.py - Structural control → Engine manager: loads engines
src/flux/cli_control.py - Kontext editing → Engine manager: loads engines
src/flux/cli_kontext.py - Engine manager → Engine configs: configures
src/flux/trt/trt_manager.py - Engine manager → Engine runtime: loads engines
src/flux/trt/trt_manager.py - Transformer engine → Engine runtime: extends runtime
src/flux/trt/engine/transformer_engine.py - VAE engines → Engine runtime: extends runtime
src/flux/trt/engine/vae_engine.py