.SAFETENSORS Dateiendung

Um .SAFETENSORS-Dateien unter Windows zu öffnen, installieren Sie Python und dann die Bibliothek: pip install safetensors.

Um eine .safetensors-Datei zu öffnen, verwenden Sie Software, die SafeTensors-Prüfpunkte laden kann – am häufigsten Python mit der Hugging Face-Safetensors-Bibliothek. Diese Dateien sind nicht dazu gedacht, wie Dokumente „geöffnet“ zu werden; Dabei handelt es sich um Modellgewichtscontainer, die Sie über die Safetensors-APIs in ML-Frameworks wie PyTorch laden.

Startseite Dateiendungs-Index Maschinelles Lernen im Index Maschinelles Lernen Kategorie-Seite

Zuletzt aktualisiert: 12. Juni 2026

Auf Ihrem Gerät öffnen

Wählen Sie Ihr Betriebssystem für eine Schritt-für-Schritt-Anleitung.

So öffnen Sie .SAFETENSORS-Dateien

Nutzen Sie diese plattformspezifischen Anleitungen, um .SAFETENSORS-Dateien sicher zu öffnen.

Windows

Installieren Sie Python und dann die Bibliothek: pip install safetensors
Laden Sie die Datei mithilfe der Safetensors-APIs in ein Python-Skript (verwenden Sie beispielsweise „safetensors.torch.load_file“ für PyTorch-Tensoren).

Vollständige Windows-Anleitung

Mac

Installieren Sie Python und dann die Bibliothek: pip install safetensors
Laden Sie die Datei mithilfe der Safetensors-APIs in ein Python-Skript (verwenden Sie beispielsweise „safetensors.torch.load_file“ für PyTorch-Tensoren).

Vollständige Mac-Anleitung

Linux

Installieren Sie Python und dann die Bibliothek: pip install safetensors
Laden Sie die Datei mithilfe der Safetensors-APIs in ein Python-Skript (verwenden Sie beispielsweise „safetensors.torch.load_file“ für PyTorch-Tensoren).

Vollständige Linux-Anleitung

iOS

Für SafeTensors wird keine allgemeine iOS-native App-Unterstützung genannt. Wenn Sie die Datei überprüfen oder verwenden müssen, übertragen Sie sie auf einen Desktop und laden Sie sie mit Python (Safetensoren).

Vollständige iOS-Anleitung

Android

Für SafeTensors wird keine allgemeine Android-native App-Unterstützung genannt. Wenn Sie die Datei überprüfen oder verwenden müssen, übertragen Sie sie auf einen Desktop und laden Sie sie mit Python (Safetensoren).

Vollständige Android-Anleitung

Sicherheitshinweise

SafeTensors ist darauf ausgelegt, Tensordaten und Metadaten (JSON-Header + Rohbytes) anstelle einer ausführbaren Serialisierungslogik zu speichern. Dies soll die Risiken reduzieren, die mit Pickle-basierten Modellkontrollpunkten verbunden sind.
Behandeln Sie nicht vertrauenswürdige Modellgewichte auch bei einem sichereren Behälter als potenziell schädlich auf der Anwendungsebene (z. B. gegnerische oder vergiftete Gewichte). Sicheres Parsen ist nicht dasselbe wie sicheres Modellverhalten.
Die Implementierung wurde von einem Dritten (Trail of Bits) überprüft, wobei der Schwerpunkt auf Validierungs- und Sicherheitseigenschaften lag. Halten Sie die Parser dennoch auf dem neuesten Stand und vermeiden Sie die Verwendung unbekannter Forks oder nicht gewarteter Loader.

Wenn Sie die Datei nicht erwartet haben

Diese Endung steht meist für Daten, Text oder strukturierte Inhalte – nicht für ein ausführbares Programm an sich. Typisch ist eher Täuschung (Betrugs-Anhang oder irreführender Dateiname). Bei vertrauenswürdigen Absendern braucht es selten pauschale Antivirus-Floskeln; die verlinkten Tools sind für die Extra-Prüfung unerwarteter Downloads gedacht.

Avast

Avast offers free and premium antivirus software that protects against viruses, malware, ransomware, and phishing. Scan files before opening them to ensure safety.

Norton

Norton 360 delivers comprehensive antivirus protection, VPN, and identity theft monitoring. Scan files for threats before opening to keep your device secure.

Wir erhalten möglicherweise eine Provision über Affiliate-Links. Das unterstützt unsere kostenlosen Dateiendungs-Guides.

Datei lässt sich nicht öffnen?

Die häufigsten Ursachen und Lösungen, wenn .SAFETENSORS-Dateien nicht geöffnet werden können.

Häufige Ursachen

Ich habe versucht, es in einem Texteditor zu öffnen, aber es sieht wie Kauderwelsch aus
Der Ladevorgang schlägt aufgrund inkompatibler dtype/shape-Erwartungen fehl
Die Datei wird heruntergeladen, die Tools melden sie jedoch als beschädigt oder unvollständig

Lösungsschritte

Verwenden Sie einen SafeTensors-fähigen Loader (üblicherweise Python + Safetensors) anstelle eines Texteditors
Wenn Sie nur Metadaten benötigen, lesen Sie nur den Header mithilfe des dokumentierten Metadaten-Parsing-Ansatzes (Header-JSON am Anfang der Datei).

Betriebssystem-spezifische Fehlerbehebung

Was ist eine .SAFETENSORS-Datei?

SafeTensors ist ein binäres Dateiformat zum Speichern eines oder mehrerer Tensoren. Das Layout ist: eine 8-Byte-Little-Endian-Header-Länge, ein UTF-8-JSON-Header, der Tensoren beschreibt (dtype, shape, data_offsets) und optional reservierte Metadaten, gefolgt von den rohen Tensor-Byte-Daten. Das Entwurfsziel ist ein sicheres und effizientes Laden (einschließlich Zero-Copy-/Lazy-Muster) durch die Verwendung expliziter Offsets und einer eingeschränkten Header-Struktur.

Hintergrund

SafeTensors wird häufig zum Verteilen und Laden neuronaler Netzwerkgewichte verwendet, insbesondere neben Hugging Face-Tools und Modellrepositorys. Anstatt sich auf Python-Pickle-basierte Formate zu verlassen (die Code beim Laden ausführen können), speichert SafeTensors nur Tensor-Metadaten plus Rohbytes und ermöglicht so eine strengere Validierung und sicherere Parsing-Ansätze.

Intern ist der Header JSON, der Tensornamen Deskriptoren zuordnet, die dtype, Form und Bytebereiche (data_offsets) im Rohdatenabschnitt enthalten. Ein reservierter „__metadata__“-Eintrag kann Schlüssel-/Wert-Metadaten speichern; Ökosystemstandards (z. B. Modellmetadatenkonventionen) können erwartete Schlüssel definieren.

Da der Header klein ist und sich am Anfang befindet, kann er gelesen werden, ohne die gesamte Datei herunterzuladen (z. B. über HTTP-Range-Anfragen). Dies macht es für große, remote gehostete Prüfpunkte praktisch: Tools können zunächst Metadaten überprüfen und dann die Tensor-Nutzlast selektiv herunterladen oder im Speicher abbilden, wenn dies unterstützt wird.

Weiterführende Literatur

Weitere Informationen zum .SAFETENSORS-Format.

Häufige .SAFETENSORS-Probleme

Ich habe versucht, es in einem Texteditor zu öffnen, aber es sieht wie Kauderwelsch aus

.safetensors ist ein Binärformat: Nur ein kleiner Header ist JSON-Text; Der Großteil besteht aus rohen Tensorbytes.

Verwenden Sie einen SafeTensors-fähigen Loader (üblicherweise Python + Safetensors) anstelle eines Texteditors
Wenn Sie nur Metadaten benötigen, lesen Sie nur den Header mithilfe des dokumentierten Metadaten-Parsing-Ansatzes (Header-JSON am Anfang der Datei).

Der Ladevorgang schlägt aufgrund inkompatibler dtype/shape-Erwartungen fehl

Der Header kodiert dtype und Shape pro Tensor; Ein konsumierendes Skript/Modell erwartet möglicherweise andere Tensornamen oder -formen als die in der Datei gespeicherten.

Listen Sie Tensornamen und deren dtype/Form aus den Header-Metadaten auf, bevor Sie sie in Ihr Modell laden
Stellen Sie sicher, dass Sie in die richtige Modellarchitektur laden und dass die Benennung des Tensors mit den Erwartungen des Modellcodes übereinstimmt

Die Datei wird heruntergeladen, die Tools melden sie jedoch als beschädigt oder unvollständig

SafeTensors basiert auf exakten Byte-Offsets (data_offsets). Ein verkürzter Download oder eine teilweise Kopie kann die Header-/Datenkonsistenz und -validierung beeinträchtigen.

Laden Sie die Datei erneut herunter oder kopieren Sie sie erneut, um sicherzustellen, dass die Übertragung vollständig abgeschlossen ist
Wenn Sie aus der Ferne lesen, stellen Sie sicher, dass Ihr HTTP-Client Range-Anfragen korrekt unterstützt, wenn er teilweise Header-Lesevorgänge durchführt

FAQ

Ist eine .safetensors-Datei nur JSON?

Nein. Nur der Header ist UTF-8 JSON; Der Inhalt des Tensors wird als rohe Binärbytes nach dem Header gespeichert.

Kann ich Tensoren extrahieren, ohne die gesamte Datei herunterzuladen?

Bei Metadaten gilt dies häufig: Der Header kann vom Anfang der Datei an gelesen werden, und die offiziellen Dokumente beschreiben das Parsen von Metadaten über HTTP-Range-Anfragen, um nur die anfänglichen Bytes abzurufen, die für den Header benötigt werden.

Wo werden Modellmetadaten in SafeTensors gespeichert?

Metadaten können im reservierten „__metadata__“-Teil des JSON-Headers gespeichert werden; Ökosystemspezifikationen (wie der Modellmetadatenstandard von Stability AI) können Konventionen für Schlüssel definieren.

Gibt es einen offiziell registrierten MIME-Typ für .safetensors?

Das IANA-Medientypenregister ist der maßgebliche Ort zur Überprüfung; Die bereitgestellte IANA-Registrierungsquelle listet keinen bestimmten registrierten Medientyp für .safetensors auf.