Safetensors documentation
Safetensors
Bắt đầu
🤗 SafetensorsSo sánh tốc độChia sẻ Tensor trong PytorchPhân tích cú pháp MetadataChuyển đổi trọng số sang safetensors
API
You are viewing main version, which requires installation from source. If you'd like
regular pip install, checkout the latest stable version (v0.5.0-rc.0).
Safetensors
Safetensors là một định dạng mới, đơn giản để lưu trữ tensor một cách an toàn (khác với pickle) và vẫn nhanh (zero-copy). Safetensors thực sự nhanh 🚀.
Cài đặt
với pip:
pip install safetensorsvới conda:
conda install -c conda-forge safetensorsCách sử dụng
Tải tensor
from safetensors import safe_open
tensors = {}
with safe_open("model.safetensors", framework="pt", device=0) as f:
for k in f.keys():
tensors[k] = f.get_tensor(k)Chỉ tải một phần các tensor (hữu ích khi chạy trên nhiều GPU)
from safetensors import safe_open
tensors = {}
with safe_open("model.safetensors", framework="pt", device=0) as f:
tensor_slice = f.get_slice("embedding")
vocab_size, hidden_dim = tensor_slice.get_shape()
tensor = tensor_slice[:, :hidden_dim]Lưu tensor
import torch
from safetensors.torch import save_file
tensors = {
"embedding": torch.zeros((2, 2)),
"attention": torch.zeros((2, 3))
}
save_file(tensors, "model.safetensors")Định dạng
Giả sử bạn có tệp safetensors tên là model.safetensors, thì model.safetensors sẽ có định dạng bên trong như sau:
Dự án nổi bật
Safetensors đang được sử dụng rộng rãi tại các doanh nghiệp AI hàng đầu, chẳng hạn như Hugging Face, EleutherAI và StabilityAI. Dưới đây là danh sách không đầy đủ các dự án đang sử dụng safetensors:
- huggingface/transformers
- ml-explore/mlx
- huggingface/candle
- AUTOMATIC1111/stable-diffusion-webui
- Llama-cpp
- microsoft/TaskMatrix
- hpcaitech/ColossalAI
- huggingface/pytorch-image-models
- CivitAI
- huggingface/diffusers
- coreylowman/dfdx
- invoke-ai/InvokeAI
- oobabooga/text-generation-webui
- Sanster/lama-cleaner
- PaddlePaddle/PaddleNLP
- AIGC-Audio/AudioGPT
- brycedrennan/imaginAIry
- comfyanonymous/ComfyUI
- LianjiaTech/BELLE
- alvarobartt/safejax
- MaartenGr/BERTopic
- rachthree/safestructures
- justinchuby/onnx-safetensors