Reference only

Spandrel is installed but the model will not load: check architecture support

Separate the library import from architecture support and the identity of the weights.

Installation is only the first checkpoint

Spandrel supports a defined set of model architectures, not every PyTorch model. Its upstream documentation distinguishes the base package from additional architectures and their licensing conditions.1

python -m pip show spandrel spandrel-extra-arches

Our suggested report combines that package record with the calling node revision and the model's original release, filename and revision. A supported extension such as .pth is not an architecture guarantee.

A missing import calls for dependency checks. An unrecognized model calls for a support check. Unexpected weight keys call for file-identity and model-structure investigation. Renaming a file is not the proposed solution.

Install additional architectures only when the task requires them and review the relevant model and architecture permissions separately. Test a small, known-source model supported by the selected version. Record import, architecture recognition and output as different outcomes; do not replace a model-specific failure with an indiscriminate environment reinstall.

Research draft. No local/GPU reproduction or independent editorial sign-off. Upstream statements and our recommendations are distinguished.

Didn't solve it?

Check the next possible cause

The same symptom can come from a different cause. Work through these related entries in order.

  1. Kornia import errors: check the base package, Torch and optional extrasNo module named korniaDistinguish a missing base package from an optional feature dependency before changing Torch.
  2. Missing safetensors package or unreadable weights? Diagnose them separatelyNo module named safetensorsDistinguish the Python library from the weight file before reinstalling packages or downloading models again.
Paste your full log into the error finder

Was this page helpful?

Anonymous. Only a yes/no counter is stored; no account, IP address or device details.

Sources & references

Research draft. No local/GPU reproduction or independent editorial sign-off. Upstream statements and our recommendations are distinguished.

01Spandrel upstream READMESource checked: 2026-09-21

Report an issue · 3167afec-679d-5672-8ac2-70bb048db594