{"record":{"id":"b1e91f44057c3931","repo":"AUTOMATIC1111/stable-diffusion-webui","slug":"taesd-model-not-found","errorCode":null,"errorMessage":"TAESD model not found","messagePattern":"TAESD model not found","errorType":"exception","errorClass":"FileNotFoundError","httpStatus":null,"severity":"warning","filePath":"modules/sd_vae_taesd.py","lineNumber":117,"sourceCode":"        model_name = \"taesd3_decoder.pth\"\n    elif shared.sd_model.is_sdxl:\n        model_name = \"taesdxl_decoder.pth\"\n    else:\n        model_name = \"taesd_decoder.pth\"\n\n    loaded_model = sd_vae_taesd_models.get(model_name)\n\n    if loaded_model is None:\n        model_path = os.path.join(paths_internal.models_path, \"VAE-taesd\", model_name)\n        download_model(model_path, 'https://github.com/madebyollin/taesd/raw/main/' + model_name)\n\n        if os.path.exists(model_path):\n            loaded_model = TAESDDecoder(model_path)\n            loaded_model.eval()\n            loaded_model.to(devices.device, devices.dtype)\n            sd_vae_taesd_models[model_name] = loaded_model\n        else:\n            raise FileNotFoundError('TAESD model not found')\n\n    return loaded_model.decoder\n\n\ndef encoder_model():\n    if shared.sd_model.is_sd3:\n        model_name = \"taesd3_encoder.pth\"\n    elif shared.sd_model.is_sdxl:\n        model_name = \"taesdxl_encoder.pth\"\n    else:\n        model_name = \"taesd_encoder.pth\"\n\n    loaded_model = sd_vae_taesd_models.get(model_name)\n\n    if loaded_model is None:\n        model_path = os.path.join(paths_internal.models_path, \"VAE-taesd\", model_name)\n        download_model(model_path, 'https://github.com/madebyollin/taesd/raw/main/' + model_name)\n","sourceCodeStart":99,"sourceCodeEnd":135,"githubUrl":"https://github.com/AUTOMATIC1111/stable-diffusion-webui/blob/82a973c04367123ae98bd9abdf80d9eda9b910e2/modules/sd_vae_taesd.py#L99-L135","documentation":"decoder_model() in sd_vae_taesd.py loads the TAESD tiny-VAE used for fast live previews. It tries to auto-download the .pth from github.com/madebyollin/taesd into models/VAE-taesd/; if after the download attempt the file still does not exist (offline, blocked GitHub, proxy failure), it raises FileNotFoundError.","triggerScenarios":"Setting Settings > Live preview VAE mode to 'TAESD' (or Cheap-Preview on older builds) on first use with no cached model, while the machine cannot reach raw.githubusercontent.com; or the download wrote a 0-byte/renamed file so os.path.exists() is false.","commonSituations":"Air-gapped or firewalled deployments; China-region networks where GitHub is unreachable; CI containers without outbound network.","solutions":["Manually download the file named in the code (taesd_decoder.pth / taesdxl_decoder.pth / taesd3_decoder.pth depending on your model) from the madebyollin/taesd GitHub repo into models/VAE-taesd/","Fix network/proxy so the auto-download works, then reload the UI","Switch live preview mode back to 'Approximation' (Settings > Live preview) which needs no extra weights"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":"import os\nfrom modules import shared, paths_internal\ndef taesd_decoder_cached():\n    name = 'taesd3_decoder.pth' if shared.sd_model.is_sd3 else ('taesdxl_decoder.pth' if shared.sd_model.is_sdxl else 'taesd_decoder.pth')\n    return os.path.exists(os.path.join(paths_internal.models_path, 'VAE-taesd', name))","typeGuard":null,"tryCatchPattern":"try:\n    dec = sd_vae_taesd.decoder_model()\nexcept FileNotFoundError:\n    # fall back to approximation preview; do not block generation\n    shared.opts.live_preview_method = 'Approximation'","preventionTips":["Pre-download TAESD weights into models/VAE-taesd/ during image build/provisioning","Keep the fallback preview mode in settings if the host has no internet","Monitor that the auto-download succeeded on first use before relying on live previews"],"tags":["vae","live-preview","network","download","taesd"],"backgroundTag":null,"analyzedSha":"82a973c04367123ae98bd9abdf80d9eda9b910e2","analyzedAt":"2026-08-14T16:46:43.225Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}