Nodes/FlowState-Creator-Nodes/πŸŒŠπŸš’ FlowState Flux Engine
ComfyUI Node

πŸŒŠπŸš’ FlowState Flux Engine

One node that loads, patches, and samples Flux β€” without the spaghetti

By flowstatelabsΒ·Created 2 years agoΒ·Updated 11 months agoΒ· 25
πŸŒŠπŸš’ FlowState Flux Engine
  • model
  • clip
  • vae
  • input_img
  • latent
  • model
  • clip
  • vae
  • image
  • latent
  • VAE
  • IMAGE
  • IMAGE
β—„model_label --- πŸ€– Model Settings --- β–Ί
β—„model_filetypeβ–Ύβ–Ί
β—„model_nameβ–Ύβ–Ί
β—„weight_dtypeβ–Ύβ–Ί
β—„aumentation_label --- πŸ”₯ Augmentation Settings --- β–Ί
β—„sage_attentionβ–Ύβ–Ί
β—„lora_modelβ–Ύβ–Ί
β—„lora_strength1.00β–Ί
β—„encoders_label --- πŸ”£ Encoder Settings --- β–Ί
β—„clip_1_nameβ–Ύβ–Ί
β—„clip_2_nameβ–Ύβ–Ί
β—„vae_nameβ–Ύβ–Ί
β—„image_label --- πŸ–ΌοΈ Image Settings --- β–Ί
β—„resolutionβ–Ύβ–Ί
β—„orientationβ–Ύβ–Ί
β—„latent_typeβ–Ύβ–Ί
β—„custom_width1024β–Ί
β—„custom_height1024β–Ί
β—„custom_batch_size1β–Ί
β—„sampling_label --- πŸ§ͺ Sampling Settings --- β–Ί
β—„seed32β–Ί
β—„sampling_algorithmβ–Ύβ–Ί
β—„scheduling_algorithmβ–Ύβ–Ί
β—„guidance3.2β–Ί
β—„steps32β–Ί
β—„denoise1.00β–Ί
β—„prompt_label --- πŸ“ Prompt(s) --- β–Ί
β—„promptβœ… Describe the image you want Flux to create.β–Ί

A stock ComfyUI Flux graph needs seven or eight nodes just to render one image: a loader, two CLIP loaders, a VAE loader, a dual text-encode, FluxGuidance, a sampler, a decoder. FlowState Flux Engine collapses that whole row into a single box. You pick a model, type a prompt, hit go. It's the node you reach for when you've built the same Flux sampler graph for the tenth time and just want to generate.

What it does under the hood

Nothing exotic - it's a thin, well-organized wrapper over ComfyUI's own building blocks. It loads your Flux model (as a solo diffusion_models/unets file via UNETLoader, or as a checkpoint, which bundles CLIP and VAE), loads the two text encoders with DualCLIPLoader, applies FluxGuidance at your guidance value, and samples with SamplerCustomAdvanced. Crucially it does the whole thing itself and also passes the loaded model, clip, and vae out, so you can still grab them and wire a detailer or upscaler downstream without re-loading anything.

Inputs that matter

  • model_filetype - solo_model vs checkpoint. Pick checkpoint and the weight_dtype, clip_1_name, clip_2_name, and vae_name fields are ignored - the tooltip says so, and it's right: they're inside the checkpoint.
  • model_name - the Flux model itself. This is the enum with no choices in the schema because it's populated from whatever's in your diffusion_models, checkpoints, and unets folders.
  • guidance - defaults to 3.2. Flux is a flow-matching, guidance-distilled model; this is not SDXL, so your old CFG 7 habits do not apply. Leave it near default and tune in small steps.
  • steps (32) and denoise (1.0) - at 1.0 it's pure text-to-image; drop denoise below 1 and feed an image via the optional input_img input for img2img work.
  • resolution / orientation / latent_type - the preset list (18 ratios, heavy on 16:9 and 21:9 for production work) or Custom, plus whether to start from empty latents or an input image.
  • seed, sampling_algorithm (44 choices), scheduling_algorithm (9) - the usual sampler knobs, in case you want euler over dpmpp_2m.
  • lora_model + lora_strength, and sage_attention - the two patching options. The LoRA is applied model-only via LoraLoaderModelOnly; Sage Attention is an optional speed patch that only ever shows a real mode if you have Sage Attention and KJNodes installed.

Outputs

model, clip, vae - the loaded components, for reuse. image (IMAGE) - the decoded result. latent (LATENT) - the same result pre-decode, for chaining another pass. You can honestly ignore all but image.

Install

Part of the FlowState Creator Suite, so the pack install is the whole story:

cd ComfyUI/custom_nodes
git clone https://github.com/flowstateeng/FlowState-Creator-Nodes

then restart, or use ComfyUI Manager and search FlowState-Creator-Nodes. The pack has no pip requirements - it wraps ComfyUI core. What you supply is the model: a Flux model (solo or checkpoint), and if solo, the dual CLIP (clip_1 + clip_2) and a VAE.

Common issues

The sage_attention menu stuck on "disabled" is the top complaint, and it's expected: the suite checks at startup whether Sage Attention and KJNodes are both present and only then exposes the modes. Sage Attention itself is famously fiddly to install because it needs a wheel matching your exact PyTorch/CUDA build - grab the right wheel from the SageAttention releases page rather than plain pip install. And if your output looks overcooked, your guidance is too high - that's the number people actually fiddle with. Everything else in this node is a convenience wrapper; the model selection and the guidance slider are where the real control lives.

CategoryFlowState Creator Suite/Flux

Inputs (33)

NameTypeDefaultDescription
model_labelSTRING --- πŸ€– Model Settings --- Label -------------------------------- - This field is not functional. It is just a label for the group of settings below.
model_filetypeCOMBO Model File Type -------------------------------- - The type of model file to load. - Checkpoints (typically for fp8 models) contain the CLIP & VAE. - If using a checkpoint, then the weight_dtype, clip_1_name, clip_2_name & vae_name fields will ignored.
model_nameCOMBO Full Diffusion Model List -------------------------------- - List of all available Diffusion Models (diffusion_models, checkpoints & unets folders).
weight_dtypeCOMBO Weight Datatype (DType) -------------------------------- - The data type to be used for your models weights.
aumentation_labelSTRING --- πŸ”₯ Augmentation Settings --- Label -------------------------------- - This field is not functional. It is just a label for the group of settings below.
sage_attentionCOMBO Sage Attention Mode -------------------------------- - The type of Sage Attention to use. - This field will only show as "disabled" if you do not have the capability to run Sage Attention.
lora_modelCOMBO LoRA List -------------------------------- - List of available Low-Rank Adaptation models. - Used to transfer a pre-trained style (cyberpunk, anime, photorealism, disney, etc.) to a generated output image.
lora_strengthFLOAT1.000–1 Low Rank Adaptation Model (LoRA) -------------------------------- - The LoRA used to patch your diffusion model.
encoders_labelSTRING --- πŸ”£ Encoder Settings --- Label -------------------------------- - This field is not functional. It is just a label for the group of settings below.
clip_1_nameCOMBO CLIP / Text Encoder List -------------------------------- - List of available Text Encoders and CLIP models. - Used to convert your text prompts into semantic attention vectors (i.e., numbers) that the model can process. - Contrastive Language-Image Pre-training (CLIP)
clip_2_nameCOMBO CLIP / Text Encoder List -------------------------------- - List of available Text Encoders and CLIP models. - Used to convert your text prompts into semantic attention vectors (i.e., numbers) that the model can process. - Contrastive Language-Image Pre-training (CLIP)
vae_nameCOMBO VAE List -------------------------------- - List of available Variational Autoencoders (VAE). - Used to encode and decode images.
image_labelSTRING --- πŸ–ΌοΈ Image Settings --- Label -------------------------------- - This field is not functional. It is just a label for the group of settings below.
resolutionCOMBO Resolution Selector -------------------------------- - Select "Custom" to use the entered custom_width & custom_height. - Select a preset resolution & orientation.
orientationCOMBO Orientaion Selector -------------------------------- - Resolutions given in horizontal orientation. Select vertical to swap resolution aspect ratio.
latent_typeCOMBO Latent Type -------------------------------- - Your choice of an empty latent (all zeros) or an image as a latent.
custom_widthINT102416–16384 Width -------------------------------- - Defines the width of the image.
custom_heightINT102416–16384 Height -------------------------------- - Defines the height of the image.
custom_batch_sizeINT11–4096 Custom Batch Size -------------------------------- - The number of images you want to generate.
sampling_labelSTRING --- πŸ§ͺ Sampling Settings --- Label -------------------------------- - This field is not functional. It is just a label for the group of settings below.
seedINT32-9223372036854776000–9223372036854776000 Seed -------------------------------- - Seed used to generate inital random noise.
sampling_algorithmCOMBO Sampling Algorithm -------------------------------- - List of available Sampling Algorithms. - Used to control the noise removal during the sampling process.
scheduling_algorithmCOMBO Scheduling Algorithm -------------------------------- - List of available Scheduling Algorithms. - Used to control the denoising steps during the sampling process.
guidanceFLOAT3.20–100 Guidance -------------------------------- - Defines the number of steps to take in the sampling process.
stepsINT321–10000 Steps -------------------------------- - Defines the number of steps to take in the sampling process.
denoiseFLOAT1.000–1 Sampler Denoise Amount -------------------------------- - The amount of denoising applied, lower values will maintain the structure of the initial image allowing for image to image sampling.
prompt_labelSTRING --- πŸ“ Prompt(s) --- Label -------------------------------- - This field is not functional. It is just a label for the group of settings below.
promptSTRINGβœ… Describe the image you want Flux to create. Positive Prompt -------------------------------- - βœ… Describe the image you want Flux to create.
modeloptMODEL Input Model -------------------------------- - Diffusion model to be used in sampling.
clipoptCLIP CLIP / Text Encoder Model -------------------------------- - The CLIP / Text Encoder model used for encoding the text.
vaeoptVAE Variational AutoEncoder (VAE) -------------------------------- - The VAE model used for encoding and decoding images.
input_imgoptIMAGEβ€”
latentoptLATENT Latent Image -------------------------------- - Input latent image for diffusion sampling.

Outputs (8)

NameTypeDescription
modelMODELThe selected Diffusion Model.
clipCLIPThe selected CLIP.
vaeVAEThe selected VAE.
imageMODELThe image batch.
latentCLIPThe latent batch.
VAEVAEβ€”
IMAGEIMAGEβ€”
IMAGEIMAGEβ€”