Missing safetensors package or unreadable weights? Diagnose them separately

A file extension is not a Python installation

Safetensors documents a package installation and tensor-reading interfaces.1 We treat failure to import that package separately from failure while it reads a particular file.

python -m pip show safetensors

For a missing import, check the interpreter and the node's dependency requirement. For a parsing error, record the exact repository, revision, path, byte size and any publisher-provided integrity value. A model family name alone is not a file identity.

Our recommended replacement procedure preserves the original: download a separate candidate, compare it, then decide whether to replace the active file. Do not rename a suffix or alter a header to suppress validation errors.

Record library import, file parsing and workflow loading as separate checks. A readable file may still be unsuitable for the chosen loader. A locally computed hash is useful for comparison, but it is not an official integrity check without a trusted reference value.

Related checks

• Spandrel is installed but the model will not load: check architecture support
• Transformers errors: separate imports, API changes and model downloads

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