Safetensors
Fast and safe tensor serialization format by Hugging Face.
About
Loading a pickled PyTorch checkpoint can execute arbitrary code, which makes sharing model weights a genuine attack surface. Safetensors, from Hugging Face, replaces pickle with a purpose-built format that cannot run code on load: a file holds an 8-byte header length, a JSON block describing each tensor's dtype, shape, and byte offsets, and then a raw little-endian data buffer. The layout enables memory-mapped, zero-copy style reads and lazy loading of individual tensors without scanning the whole file; the README cites loading BLOOM across 8 GPUs dropping from 10 minutes to 45 seconds compared with standard PyTorch loading. The format also forbids overlapping tensor regions, closing off a class of denial-of-service tricks. Implementations exist in Python and Rust, and safetensors is now the default weight format across the Hugging Face Hub, used by practitioners anywhere untrusted models are downloaded or large models need fast startup. Apache 2.0 licensed.
Should you use Safetensors?
Pick it when
Pick this whenever you save or publish model weights that other people will load, since files cannot execute code on load, and when large checkpoints must start fast through memory-mapped, lazy per-tensor reads.
Look elsewhere when
It stores tensors only, not the architecture or compute graph, so it cannot replace ONNX for cross-framework deployment. For quantized local LLM files used by llama.cpp-style runtimes, GGUF from GGML is the usual container instead.
Alternatives to Safetensors
- ONNX
Captures the full compute graph so models run in other engines and languages; a heavier export step that can fail on custom operators.
- GGML
Its GGUF format packs quantized weights and metadata for llama.cpp-style local inference; the right container there, less so for training checkpoints.
- PyTorch
Pickle-based torch.save checkpoints hold arbitrary Python objects such as optimizer state; flexible, but loading untrusted ones unrestricted can run code.
Reviews (0)
Leave a Review
No reviews yet. Be the first to review!
Details
- Category
- AI Frameworks & Libraries
- Price
- Free
- Platform
- Local/Desktop
- Difficulty
- Beginner (1/5)
- License
- Apache-2.0
- Added
- Apr 3, 2026