Hva er en SafeTensors-fil?

En fil med endelsen .safetensors lagrer tensorer og tilhørende metadata i et enkelt modellserialiseringsformat som er utformet for å unngå risikoen for vilkårlig kodekjøring forbundet med pickle-baserte vektfiler. Dette er et modellartefakt, ikke en garanti for at en modell er pålitelig, kompakt eller kan gjenopprettes for alltid.

Hva formatet inneholder

SafeTensors-formatet lagrer en header som beskriver tensorene, typene, formene og byteforskyvningene deres, fulgt av selve tensordataene. Rammeverksspesifikke biblioteker kan laste vektene uten å be en Python-pickle-innlaster om å kjøre serialisert kode som en del av deserialiseringen.

En SafeTensors-fil kan være en basismodell, en LoRA-adapter, en komponent i en større modell eller én del av en modell med flere filer. Filendelsen alene forteller ikke hvilket kjøremiljø som forventer den, hvilken base en LoRA trenger, eller om filen utgjør hele artefaktsettet for et prosjekt.

Hva «safe» betyr og ikke betyr

Formatsikkerhet er ikke det samme som tillit til kilden. SafeTensors reduserer én type innlastingsrisiko sammenlignet med pickle-basert serialisering. Det fastslår ikke at modellvektene passer til oppgaven din, kommer fra en pålitelig utgiver, oppfyller opphaverens lisens eller oppfører seg trygt i en applikasjon.

SafeTensors er verken et arkiv eller en kvantisering

SafeTensors er en representasjon av modellvekter. Et arkiv er en arbeidsflyt for bevaring og gjenoppretting av filer du allerede har. Kvantisering er en tilsiktet endring av modellens numeriske representasjon for et bestemt kjøremiljø eller ressursmål. De kan forekomme i samme prosjekt, men løser forskjellige problemer.

Hvis de opprinnelige bytene må kunne gjenopprettes, må du ikke behandle en konvertering som den eneste kopien. Hvis du trenger en mindre, endret kjøretidsrepresentasjon, vurderer du kvantisering på egne premisser. Les SafeTensors-lagring kontra kvantisering for å se skillet i praksis.

Slik gjør du filen forståelig i et modellbibliotek

• Hold basen, adapteren og prosjektkonteksten koblet sammen i navnet eller oversikten du kontrollerer.
• Ikke anta at én .safetensors-fil er en selvstendig modell.
• Bruk dokumentasjonen for målkjøremiljøet til å fastslå hvordan artefaktet skal lastes.
• Når en ferdig, beslektet familie er viktig, beholder du en uavhengig sikkerhetskopi der det er hensiktsmessig, og dokumenterer en separat gjenoppretting før opprydding.

Det neste nyttige spørsmålet

Hvis du velger en lokal inferensbeholder, sammenligner du SafeTensors og GGUF ut fra kjøremiljø og gjenopprettingsmål. Hvis du undersøker en hel disk, er det neste spørsmålet vanligvis ikke «kan jeg åpne denne filen?», men «hva bør jeg beholde samlet?» Begynn med én base og flere adaptere, eller bruk sjekklisten for bevaring av modellbiblioteket.