{"record":{"id":"4e5a616bd6e2de63","repo":"invoke-ai/InvokeAI","slug":"unknown-variant-for-flux-transformer-params-vari","errorCode":null,"errorMessage":"Unknown variant for FLUX transformer params: {variant}","messagePattern":"Unknown variant for FLUX transformer params: (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"invokeai/backend/flux/util.py","lineNumber":195,"sourceCode":"        context_in_dim=12288,  # 3 layers * 4096 = 12288 for Qwen3-8B\n        hidden_size=3072,\n        mlp_ratio=4.0,\n        num_heads=24,\n        depth=19,\n        depth_single_blocks=38,\n        axes_dim=[16, 56, 56],\n        theta=10_000,\n        qkv_bias=True,\n        guidance_embed=False,\n    ),\n}\n\n\ndef get_flux_transformers_params(variant: AnyVariant):\n    try:\n        return _flux_transformer_params[variant]\n    except KeyError:\n        raise ValueError(f\"Unknown variant for FLUX transformer params: {variant}\")\n","sourceCodeStart":177,"sourceCodeEnd":196,"githubUrl":"https://github.com/invoke-ai/InvokeAI/blob/0b6a024f2ff6a86bfb953dcdb9cc504ef7397a06/invokeai/backend/flux/util.py#L177-L196","documentation":"get_flux_transformers_params returns the FluxParams configuration for a given FLUX variant from the _flux_transformer_params dict. An unrecognized variant raises ValueError. This is called during model loading (single-file loader, XLabs controlnet, SDNQ checkpoints), so an invalid variant blocks model construction entirely.","triggerScenarios":"Loading a FLUX checkpoint where the detected/declared variant string is not a key of _flux_transformer_params — e.g. new community variants (kontext, fill, depth, flux2) absent from this InvokeAI version, or misspelled variant in a config/model-manager record.","commonSituations":"Community fine-tunes labeled with novel variant names; older InvokeAI version encountering newer FLUX releases; variant inference from file metadata returning an unexpected string.","solutions":["Check _flux_transformer_params in invokeai/backend/flux/util.py for supported keys and use one of them","Upgrade InvokeAI to a version that supports your FLUX variant","Fall back to the closest supported variant's params if the architecture matches","Register the new variant in _flux_transformer_params when extending the codebase"],"exampleFix":"// before\nparams = get_flux_transformers_params(\"flux.2-dev\")\n// after\nparams = get_flux_transformers_params(\"flux-dev\")  # supported variant, or upgrade InvokeAI","handlingStrategy":"try-catch","validationCode":"from invokeai.backend.flux.util import _flux_transformer_params\nassert variant in _flux_transformer_params, f\"unsupported FLUX variant: {variant}\"","typeGuard":null,"tryCatchPattern":"try:\n    params = get_flux_transformers_params(variant)\nexcept ValueError as e:\n    logging.warning(\"%s — falling back to flux-dev params\", e)\n    params = get_flux_transformers_params(\"flux-dev\")","preventionTips":["Validate variant strings against the supported keys before loading","Keep InvokeAI updated for new FLUX releases","Normalize variant labels (case/spacing) before lookup"],"tags":["flux","variant-lookup","model-loading","unsupported-value"],"backgroundTag":"unsupported-value","analyzedSha":"0b6a024f2ff6a86bfb953dcdb9cc504ef7397a06","analyzedAt":"2026-08-29T04:46:49.967Z","schemaVersion":2},"datasetVersion":"2026-08-29T07:17:48.351Z"}