> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-feat-cli-docs-generator.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 環境変数

> W&B 環境変数を設定します。

スクリプトを自動化された環境で実行するとき、スクリプトの実行前またはスクリプト内で設定された環境変数を使って **wandb** を制御できます。

```bash theme={null}
# これは秘密であり、バージョン管理にチェックインするべきではありません
WANDB_API_KEY=$YOUR_API_KEY
# 名前とメモはオプションです
WANDB_NAME="My first run"
WANDB_NOTES="Smaller learning rate, more regularization."
```

```bash theme={null}
# wandb/settingsファイルをチェックインしない場合にのみ必要です
WANDB_ENTITY=$username
WANDB_PROJECT=$project
```

```python theme={null}
# スクリプトをクラウドに同期したくなければ
os.environ["WANDB_MODE"] = "offline"

# Sweep IDの追跡をRunオブジェクトと関連クラスに追加
os.environ["WANDB_SWEEP_ID"] = "b05fq58z"
```

## オプションの環境変数

これらのオプションの環境変数を使用して、リモートマシンでの認証をセットアップすることができます。

| 変数名                         | 使用法                                                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **WANDB\_ANONYMOUS**        | `allow`, `never`, または `must` に設定して、ユーザーが秘密のURLで匿名のrunsを作成できるようにします。                                                                                                                              |
| **WANDB\_API\_KEY**         | あなたのアカウントに関連付けられた認証キーを設定します。キーは[設定ページ](https://app.wandb.ai/settings)で確認できます。このキーは、リモートマシンで `wandb login` が実行されていない場合に設定する必要があります。                                                               |
| **WANDB\_BASE\_URL**        | [wandb/local](/ja/platform/hosting/)を使用している場合、この環境変数を `http://YOUR_IP:YOUR_PORT` に設定してください。                                                                                                      |
| **WANDB\_CACHE\_DIR**       | これはデフォルトで \~/.cache/wandb に設定されています。この環境変数を使用してこの場所を上書きすることができます。                                                                                                                                |
| **WANDB\_CONFIG\_DIR**      | これはデフォルトで \~/.config/wandb に設定されています。この環境変数を使用してこの場所を上書きすることができます。                                                                                                                               |
| **WANDB\_CONFIG\_PATHS**    | カンマで区切られたyamlファイルのリストをwandb.configにロードします。[config](/ja/models/track/config/#file-based-configs)を参照してください。                                                                                        |
| **WANDB\_CONSOLE**          | stdout / stderr ロギングを無効にする場合はこれを "off" に設定します。これが機能する環境では、デフォルトで "on" に設定されています。                                                                                                                 |
| **WANDB\_DATA\_DIR**        | ステージングアーティファクトがアップロードされる場所。デフォルトの場所はプラットフォームに依存し、`platformdirs` Pythonパッケージからの `user_data_dir` の値を使用します。                                                                                         |
| **WANDB\_DIR**              | すべての生成されたファイルを *wandb* ディレクトリーではなくここに保存するために絶対パスを設定します。*このディレクトリーが存在しており、プロセスが実行されるユーザーが書き込めることを確認してください*。この設定は、ダウンロードされたアーティファクトの場所には影響しません、それらの場所を設定するには代わりに *WANDB\_ARTIFACT\_DIR* を使用してください。 |
| **WANDB\_ARTIFACT\_DIR**    | すべてのダウンロードされたアーティファクトを *artifacts* ディレクトリーではなくここに保存するために絶対パスを設定します。このディレクトリーが存在しており、プロセスが実行されるユーザーが書き込めることを確認してください。この設定は、生成されたメタデータファイルの場所には影響しません、それらの場所を設定するには代わりに *WANDB\_DIR* を使用してください。    |
| **WANDB\_DISABLE\_GIT**     | gitリポジトリをプローブし、最新のコミット / 差分をキャプチャするのを防ぎます。                                                                                                                                                       |
| **WANDB\_DISABLE\_CODE**    | ノートブックやgit差分の保存を防ぐためにtrueに設定します。gitリポジトリ内にいる場合、依然として現在のコミットを保存します。                                                                                                                               |
| **WANDB\_DOCKER**           | dockerイメージのダイジェストを設定してrunsの復元を有効にします。これはwandb dockerコマンドで自動的に設定されます。イメージダイジェストを取得するには `wandb docker my/image/name:tag --digest` を実行します。                                                          |
| **WANDB\_ENTITY**           | あなたのrunに関連付けられたentityです。トレーニングスクリプトのディレクトリーで `wandb init` を実行した場合、*wandb* という名前のディレクトリーが作成され、デフォルトのentityが保存され、ソース管理にチェックインされます。このファイルを作成したくない場合やファイルを上書きしたい場合、環境変数を使用できます。                      |
| **WANDB\_ERROR\_REPORTING** | wandbが致命的なエラーをエラートラッキングシステムにログするのを防ぎたい場合はfalseに設定します。                                                                                                                                            |
| **WANDB\_HOST**             | システムが提供するホスト名を使用せずにwandbインターフェースで表示したいホスト名を設定します。                                                                                                                                                |
| **WANDB\_IGNORE\_GLOBS**    | 無視するファイルのグロブのカンマ区切りリストを設定します。これらのファイルはクラウドに同期されません。                                                                                                                                              |
| **WANDB\_JOB\_NAME**        | `wandb` が作成するジョブに対する名前を指定します。                                                                                                                                                                    |
| **WANDB\_JOB\_TYPE**        | ジョブタイプを指定します。「トレーニング」や「評価」など、異なるタイプのrunsを示します。詳細については[grouping](/ja/models/runs/grouping/)を参照してください。                                                                                             |
| **WANDB\_MODE**             | "offline" に設定すると、wandbはrunメタデータをローカルに保存し、サーバーに同期しなくなります。`disabled` に設定すると、wandbは完全にオフになります。                                                                                                      |
| **WANDB\_NAME**             | あなたのrunの人間が読める名前。設定されていない場合、ランダムに生成されます。                                                                                                                                                         |
| **WANDB\_NOTEBOOK\_NAME**   | jupyterで実行されている場合、この変数でノートブックの名前を設定できます。これを自動検出しようとします。                                                                                                                                          |
| **WANDB\_NOTES**            | あなたのrunに関する長いメモ。Markdownが許可されており、UIで後で編集できます。                                                                                                                                                    |
| **WANDB\_PROJECT**          | あなたのrunに関連付けられたプロジェクトです。これも `wandb init` で設定できますが、環境変数は値を上書きします。                                                                                                                                 |
| **WANDB\_RESUME**           | デフォルトでは *never* に設定されています。*auto* に設定すると、wandbは自動的に失敗したrunsを再開します。*must* に設定すると、開始時に必ずrunが存在するように強制します。常に独自のユニークなIDを生成したい場合、*allow* に設定して常に **WANDB\_RUN\_ID** を設定してください。                         |
| **WANDB\_RUN\_GROUP**       | 自動的にrunsをまとめるためのexperiment nameを指定します。詳細については[grouping](/ja/models/runs/grouping/)を参照してください。                                                                                                     |
| **WANDB\_RUN\_ID**          | スクリプトの単一runに対応する、グローバルにユニークな文字列（プロジェクトごとに）を設定します。64文字以内でなければなりません。すべての非単語文字はダッシュに変換されます。失敗時の既存のrunを再開するために使用できます。                                                                                |
| **WANDB\_SILENT**           | wandbログステートメントを黙らせるために **true** に設定します。これを設定すると、すべてのログが **WANDB\_DIR**/debug.log に書き込まれます。                                                                                                       |
| **WANDB\_SHOW\_RUN**        | あなたのオペレーティングシステムがサポートしていれば、runのURLを自動的にブラウザで開くために **true** に設定します。                                                                                                                               |
| **WANDB\_SWEEP\_ID**        | `Run` オブジェクトおよび関連クラスにSweep IDの追跡を追加し、UIに表示します。                                                                                                                                                   |
| **WANDB\_TAGS**             | runに適用されるタグのカンマ区切りリスト。                                                                                                                                                                           |
| **WANDB\_USERNAME**         | runに関連付けられたあなたのチームメンバーのユーザー名。これは、サービスアカウントAPIキーと共に使用して、自動化されたrunsをあなたのチームのメンバーに帰属させることができます。                                                                                                     |
| **WANDB\_USER\_EMAIL**      | runに関連付けられたあなたのチームメンバーのメール。これはサービスアカウントAPIキーと共に使用して、自動化されたrunsをあなたのチームのメンバーに帰属させることができます。                                                                                                        |

## Singularity 環境

[Singularity](https://singularity.lbl.gov/index.html)でコンテナを実行している場合、上記の変数に **SINGULARITYENV\_** をプレフィックスとしてつけて環境変数を渡すことができます。Singularity環境変数に関する詳細は[こちら](https://singularity.lbl.gov/docs-environment-metadata#environment)で確認できます。

## AWSでの実行

AWSでバッチジョブを実行している場合、W\&Bのクレデンシャルでマシンを認証するのは簡単です。[設定ページ](https://app.wandb.ai/settings)からAPIキーを取得し、[AWSバッチジョブ仕様](https://docs.aws.amazon.com/batch/latest/userguide/job_definition_parameters.html#parameters)で `WANDB_API_KEY` 環境変数を設定します。
