{"record":{"id":"24e230d293a11f3c","repo":"invoke-ai/InvokeAI","slug":"unknown-backbone-name-available-list-pipeli","errorCode":null,"errorMessage":"Unknown backbone '{name}'. Available: {list(PIPELINE_REGISTRY.keys())}","messagePattern":"Unknown backbone '(.+?)'\\. Available: (.+?)","errorType":"exception","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"invokeai/backend/pid/_src/inference/pipeline_registry.py","lineNumber":174,"sourceCode":"        spatial_compression=8,\n        # ZImage-Turbo shares ZImage's VAE/latent convention. Runtime values are\n        # read from pipeline.vae.config by denormalize_latent().\n        vae_scale_factor=0.0,\n        vae_shift_factor=0.0,\n        default_resolution=(1024, 1024),\n        # The model card describes Turbo as an 8-NFE distilled model. Diffusers'\n        # example uses num_inference_steps=9, yielding 8 non-zero scheduler jumps\n        # followed by the terminal sigma=0 sample.\n        default_num_inference_steps=9,\n        default_guidance_scale=0.0,\n        extra_generate_kwargs={\"max_sequence_length\": 512},\n    ),\n}\n\n\ndef get_config(name: str) -> DiffusionPipelineConfig:\n    if name not in PIPELINE_REGISTRY:\n        raise ValueError(f\"Unknown backbone '{name}'. Available: {list(PIPELINE_REGISTRY.keys())}\")\n    return PIPELINE_REGISTRY[name]\n\n\n# ---------------------------------------------------------------------------\n# Pipeline loading\n# ---------------------------------------------------------------------------\n\n\ndef load_pipeline(\n    name: str, model_id: Optional[str] = None, dtype=torch.bfloat16, device: str = \"cuda\", cpu_offload: bool = False\n):\n    \"\"\"Dynamically import and load a diffusers pipeline.\n\n    Args:\n        cpu_offload: If True, use enable_model_cpu_offload() instead of .to(device).\n            Keeps model weights on CPU and only moves the active component to GPU during\n            forward pass. Essential for large models (Flux2, QwenImage, etc.) that exceed\n            single-GPU VRAM when all components are loaded simultaneously.","sourceCodeStart":156,"sourceCodeEnd":192,"githubUrl":"https://github.com/invoke-ai/InvokeAI/blob/0b6a024f2ff6a86bfb953dcdb9cc504ef7397a06/invokeai/backend/pid/_src/inference/pipeline_registry.py#L156-L192","documentation":"get_config resolves a backbone name to a DiffusionPipelineConfig from PIPELINE_REGISTRY. An unknown name raises ValueError listing all registered backbones. This is the entry-point validation for load_pipeline.","triggerScenarios":"Calling get_config(name) or load_pipeline(name, ...) with a backbone string not in PIPELINE_REGISTRY — typos, old names removed in a refactor, or custom backbones never registered.","commonSituations":"Config files referencing a backbone id from an older library version; case mismatch ('Rae' vs 'rae'); forgetting to import/execute the module that registers a custom backbone.","solutions":["Use one of the names printed in 'Available:' from PIPELINE_REGISTRY.keys().","Fix the casing/spelling in your config or call site.","For custom pipelines, register the config in PIPELINE_REGISTRY (or import its registration module) before calling load_pipeline."],"exampleFix":"// before\nload_pipeline('RAE-2k')\n// after\nload_pipeline('rae')  # a key listed in PIPELINE_REGISTRY","handlingStrategy":"validation","validationCode":"from invokeai.backend.pid._src.inference.pipeline_registry import PIPELINE_REGISTRY\nif name not in PIPELINE_REGISTRY:\n    raise ValueError(f'unknown backbone {name!r}; available: {sorted(PIPELINE_REGISTRY)}')","typeGuard":"def is_registered_backbone(name: str) -> bool:\n    from invokeai.backend.pid._src.inference.pipeline_registry import PIPELINE_REGISTRY\n    return name in PIPELINE_REGISTRY","tryCatchPattern":"try:\n    cfg = get_config(name)\nexcept ValueError as e:\n    logger.error('Unknown backbone: %s', e)\n    raise SystemExit(f'Pick one of: {sorted(PIPELINE_REGISTRY.keys())}') from e","preventionTips":["Generate config choices dynamically from PIPELINE_REGISTRY.keys().","Keep backbone ids lowercase and copy-paste them rather than retyping.","Grep release notes for renamed backbone ids after upgrades."],"tags":["valueerror","pipeline-registry","config","pid"],"backgroundTag":"invalid-enum-value","analyzedSha":"0b6a024f2ff6a86bfb953dcdb9cc504ef7397a06","analyzedAt":"2026-08-29T04:46:49.967Z","schemaVersion":2},"datasetVersion":"2026-08-29T07:17:48.351Z"}