Safetensors
Safetensorsとは、Hugging Faceによるモデルの重みを保存するためのファイル形式です。Pythonのpickleファイルと異なり、読み込み時に隠れたコードが実行されることはなく、個々のテンソルをメモリマップで高速に読み込めます。
別名: .safetensors
執筆 Divya Sharma · 2026年11月15日確認 · レビューの方法
モデルの重みは以前、主にPyTorchの.binや.ptファイルで共有されていました。これらはPythonのpickle形式を使います。pickleファイルを読み込むと任意のコードが実行されうるため、ダウンロードしたモデルにマルウェアが仕込まれている可能性がありました。Safetensorsは、読み込みの速さを保ちながらそのリスクを取り除くために作られました。
仕組み
safetensorsファイルには、各テンソルの名前、データ型、形状、位置を列挙した短いJSONヘッダーがあり、その後に生のテンソルのバイト列が続きます。コードは含まれず、データだけです。レイアウトが事前にわかっているため、ローダーはファイルをメモリにマップし、ファイル全体を走査せずに必要なテンソルだけを読み込めます。プロジェクトはこれをゼロコピーと遅延読み込みと呼んでおり、モデルを複数のGPUに分割するときに役立ちます。
なぜ重要か
Safetensorsは、Hugging Face hubとTransformersライブラリで一般的な形式です。リポジトリにsafetensorsとpickleの両方のファイルがある場合は、safetensorsを選んでください。汚染されたモデルファイルが自分のマシンでコードを実行するようなAIサプライチェーン攻撃に対する、簡単な防御の1つです。
GGUFとの違い
どちらもモデルの重みを保存します。Safetensorsは、Pythonの学習とサービングのスタックで使われる中立的なコンテナで、重みは通常、完全精度か半精度です。GGUFはllama.cppと関連するローカル実行ツールの形式で、トークナイザーなどのメタデータを同梱し、主に量子化されたモデルに使われます。モデルをローカルで動かすために、safetensorsからGGUFに変換することがよくあります。
限界
Safetensorsが安全にするのは読み込みであって、モデルそのものではありません。ファイルに悪い振る舞いをする重みが含まれていることはありえますし、リポジトリ内の読み込み用のコードが安全でない可能性も残ります。
関連用語
- モデルの重み
- モデルの重み(model weights)とは、ニューラルネットワーク内部の学習済みの数値で、学習中に決まり、入力を出力に変える方法を決定します。チェックポイントとは、その重みを含む保存済みのファイルまたはファイル群です。
- GGUF
- GGUF は、モデルの重み、トークナイザー、メタデータを 1 つのファイルに保存するバイナリのファイル形式です。llama.cpp などの GGML ベースのツールでの高速な読み込みとローカル推論のために作られており、量子化された形で使われることが多くあります。
- AI サプライチェーン攻撃
- AI サプライチェーン攻撃(AI supply-chain attack)とは、AI アプリケーションを直接攻撃するのではなく、ダウンロードしたモデル、LoRA アダプター、データセット、Python パッケージ、MCP サーバー、エージェントスキルなど、アプリケーションが依存するものを通じて侵害する攻撃です。
- オープンウェイトモデル
- オープンウェイトモデル(open-weight model)とは、学習済みの重みが公開され、誰でもダウンロードして実行できるモデルです。学習コードや学習データ全体は含まれないことが多く、必ずしもオープンソースではありません。
- 量子化
- 量子化(quantization)とは、モデルの重み、場合によっては活性化を、16ではなく8や4など少ないビット数で保存する技術です。モデルに必要なメモリが減り、多くの場合は速く動きますが、精度は多少犠牲になります。