# 環境変数

Boolean 変数は、大文字小文字を問わず `1`、`on`、`yes`、または `true` を受け入れます。それ以外（未設定を含む）は false と扱われます。

これらの変数のほとんどは、Transformers がインポートされる際に一度だけ読み取られます。Python を起動する前にシェルで設定するか、インポートの前に [os.environ](https://docs.python.org/3/library/os.html#os.environ) を使用して設定してください。その後に値を変更しても、効果はありません。

```bash
TRANSFORMERS_VERBOSITY=info python run.py
```

キャッシュと Hub へのアクセスは、[huggingface_hub](https://huggingface.co/docs/huggingface_hub/package_reference/environment_variables) が管理する `HF_*` 変数（`HF_HOME` や `HF_HUB_OFFLINE` など）によって設定されます。オフラインワークフローについては、[インストール](../installation#offline-mode) を参照してください。

## ログ出力

Transformers は `warning` レベルでログを出力します。[Logging](../main_classes/logging) では、[logging.set_verbosity()](/docs/transformers/main/ja/main_classes/logging#transformers.utils.logging.set_verbosity) を含む、同等の Python API について説明しています。

| 変数 | 値 | 説明 |
|---|---|---|
| `TRANSFORMERS_VERBOSITY` | `detail`, `debug`, `info`, `warning`, `error`, `critical` | ライブラリのログレベル。`detail` は `debug` と同じ内容に、各メッセージへファイル名と行番号を追加します。認識されない値が指定された場合は警告が表示され、`warning` にフォールバックします。 |
| `TRANSFORMERS_NO_ADVISORY_WARNINGS` | boolean | 問題を示さないベストプラクティスのヒントであるアドバイザリー警告を無効にします。 |

## モデルの読み込み

チェックポイントのシャードは、デフォルトで並列に読み込まれます。

| 変数 | 値 | 説明 |
|---|---|---|
| `HF_DEACTIVATE_ASYNC_LOAD` | boolean | `device_map`がディスクにオフロードする場合や、オンザフライで量子化する場合を除き、シャードの読み込みはすでにシーケンシャルです。そのため、このオプションが影響するのは、それ以外で並列読み込みが行われる場合のみです。 |
| `DISABLE_SAFETENSORS_CONVERSION` | boolean | PyTorchの`.bin`ウェイトのみを同梱しているリポジトリに対して、TransformersがHubの変換ボットにsafetensorsバージョンの取得を要求することを防止します。CIで設定することをお勧めします。CIでは、この要求がレイテンシやネットワークの不安定性を引き起こすためです。 |

## カーネルとバックエンド

[kernels](https://github.com/huggingface/kernels) がインストールされ、ハードウェアが対応している場合、最適化されたカーネルは Hub からダウンロードされます。数値上の差異やクラッシュを切り分けるために、これらを無効にしてください。

| 変数 | 値 | 説明 |
|---|---|---|
| `USE_HUB_KERNELS` | boolean型、デフォルトで有効 | false の値に設定すると、参照実装にフォールバックします。 |
| `TRANSFORMERS_DISABLE_DEEPGEMM_LINEAR` | `1` | finegrained FP8 量子化における FP8 線形層で、DeepGEMM の代わりに Triton フォールバックを強制します。 |
| `TRANSFORMERS_DISABLE_TORCH_CHECK` | `1` | インポート時のPyTorchの最低バージョンチェックをスキップします。 |
| `TRANSFORMERS_SDPA_FORCE_GQA` | `1` | PyTorch SDPA がグループクエリアテンションに対して `enable_gqa=True` を使用するように強制します。それ以外の場合、Transformers は `enable_gqa=True` を設定するか、キー/バリューヘッドを繰り返すかのいずれかを選択します。 |

> [!WARNING]
> `TRANSFORMERS_DISABLE_TORCH_CHECK` は、動作を変更するのではなく、ガードを削除するものです。サポートされていない PyTorch バージョンでは、明確なメッセージの代わりに、インポートエラーや、静かに間違った結果が返される可能性があります。