> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

> W&B をインストールして、機械学習の実験のトラッキング、可視化、管理を数分で始めましょう。

# W&B クイックスタート

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "View source" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
      </>}
  </a>;

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Try in Colab
  </a>;

<div style={{ display: 'flex', gap: '12px', flexWrap: 'wrap' }}>
  <ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/run_quickstart.ipynb" />

  <GitHubLink url="https://github.com/wandb/examples/blob/master/colabs/intro/run_quickstart.ipynb" />
</div>

W\&B をインストールすると、規模を問わず機械学習の実験をトラッキング、可視化、管理できます。

<Note>
  W\&B Weave に関する情報をお探しの場合は、[Weave Python SDK クイックスタート](/ja/products/wandb/weave/quickstart)または [Weave TypeScript SDK クイックスタート](/ja/products/wandb/weave/reference/generated_typescript_docs/intro-notebook)を参照してください。
</Note>

<h2 id="create-an-account">
  アカウントを作成する
</h2>

初めてサインインすると、簡単なセットアップ手順を経てアカウントが作成され、組織に関連付けられます。表示されるステップは、どのような経路でアクセスしたかによって異なります。

<Steps>
  <Step title="サインイン方法を選択する">
    **Continue with Google**、**Continue with GitHub**、**Continue with Apple**、**Continue with Microsoft** のいずれかを選択するか、メールアドレスとパスワードでサインアップします。

    Weights & Biases の認証情報をすでにお持ちの場合は、その認証情報でサインインできます。**Sign up** ではなく **Log in** を選択してください。
  </Step>

  <Step title="メールアドレスを検証する">
    アカウントに登録したメールアドレスの受信トレイに届いた検証用リンクを確認します。メールが届かない場合は、迷惑メールフォルダーを確認するか、**Resend email** を選択してください。
  </Step>

  <Step title="アカウントに登録する">
    氏名、所属する組織または機関、ユーザー名を入力します。ユーザー名はプロフィール URL として使用されるため、一意である必要があります。ユーザー名に使用できるのは、英字、数字、アンダースコア、ハイフンのみです。

    **How will you use Forge?** では、個人または業務のプロジェクトで使用する場合は **Professional** を、研究または教育で使用する場合は **Academic** を選択します。

    続行するには、利用規約とプライバシーポリシーに同意します。
  </Step>

  <Step title="チームに参加する">
    メールドメインが一致する組織に参加可能なチームがある場合は、そのいずれかのチームに参加できます。

    チームの招待からアクセスした場合、またはすでにチームに所属している場合、このステップは表示されません。
  </Step>

  <Step title="組織を作成する">
    組織に名前を付けます。この名前は、`forge.coreweave.com/my-organization` のように組織の URL の一部になります。

    前のステップでチームに参加した場合、チームの招待からアクセスした場合、またはすでにチームに所属している場合、このステップは表示されません。
  </Step>

  <Step title="取り組む内容を選択する">
    **Train and fine-tune models**、**Build and evaluate agents**、**Run inference at scale**、**I'm exploring** のいずれかを選択します。選択内容に応じて次に表示されるページが決まりますが、使用できるプロダクトが制限されることはありません。
  </Step>
</Steps>

セットアップ手順が完了すると、アカウントを使用できるようになります。

<h2 id="create-an-api-key">
  APIキーを作成する
</h2>

マシンを認証するには、APIキーを作成します。

APIキーを作成する手順については、**個人用 APIキー** タブまたは **サービスアカウント APIキー** タブを選択して確認してください。

<Tabs>
  <Tab title="個人用 APIキー">
    自分のユーザー ID に紐づく個人用 APIキーを作成するには、次の手順を実行します。

    1. Forge にログインし、ユーザープロフィールアイコンをクリックして **User settings** を選択します。
    2. **API keys** セクションで **New key** を選択します。
    3. APIキーにわかりやすい名前を付けます。
    4. **Create API key** をクリックします。
    5. 表示された APIキーをすぐにコピーし、安全な場所に保管します。
  </Tab>

  <Tab title="サービスアカウント APIキー">
    サービスアカウントが所有するAPIキーを作成するには、次の手順を実行します。

    1. チーム設定または組織設定で、**Service Accounts** タブに移動します。
    2. 一覧から対象のサービスアカウントを検索します。
    3. **action (<Icon icon="ellipsis" iconType="solid" />)** メニューをクリックし、**Create API key** をクリックします。
    4. APIキーの名を入力し、**Create** をクリックします。
    5. 表示されたAPIキーをすぐにコピーし、安全な場所に保管してください。
    6. **Done** をクリックします。

    1つのサービスアカウントに複数のAPIキーを作成して、さまざまな環境やワークフローをサポートできます。
  </Tab>
</Tabs>

<Warning>
  W\&Bでは、完全なAPIキーは作成時に一度だけ表示されます。ダイアログを閉じた後は、完全なAPIキーを再表示することはできません。設定画面にはキーID (キーの先頭部分) のみが表示されます。完全なAPIキーを紛失した場合は、新しいAPIキーを作成する必要があります。
</Warning>

安全な保管方法については、[APIキーを安全に保管する](/ja/products/wandb/platform/app/settings-page/user-settings#store-and-handle-api-keys-securely) を参照してください。

<h2 id="install-the-wandb-library-and-log-in">
  `wandb` ライブラリをインストールしてログインする
</h2>

<Tabs>
  <Tab title="Command line">
    1. `WANDB_API_KEY` [環境変数](/ja/products/wandb/track/environment-variables)を設定します。`YOUR_API_KEY` は、作成したAPIキーに置き換えてください。

       ```bash theme={"system"}
       export WANDB_API_KEY=YOUR_API_KEY
       ```

    2. `wandb` ライブラリをインストールしてログインします。

       ```shell theme={"system"}
       pip install wandb
       wandb login
       ```
  </Tab>

  <Tab title="Python">
    1. `pip` で W\&B Python SDK をインストールします。

       ```bash theme={"system"}
       pip install wandb
       ```

    2. W\&B Python SDK をインポートし、Python スクリプトで `wandb.login()` を実行して W\&B にログインします。

       ```python theme={"system"}
       import wandb

       wandb.login()
       ```
  </Tab>

  <Tab title="Python notebook">
    1. シェルエスケープ (`!`) を使用して W\&B Python SDK をインストールします。

       ```notebook theme={"system"}
       !pip install wandb
       ```

    2. W\&B Python SDK をインポートし、ノートブックで `wandb.login()` を実行して W\&B にログインします。

       ```notebook theme={"system"}
       import wandb
       wandb.login()
       ```
  </Tab>
</Tabs>

<h2 id="initialize-a-run-and-track-hyperparameters">
  run を初期化してハイパーパラメーターをトラッキングする
</h2>

Python スクリプトまたはノートブックで、[`wandb.init()`](/ja/products/wandb/ref/python/experiments/run) を使用して W\&B の Run オブジェクトを初期化します。`config` パラメーターに辞書を渡して、
ハイパーパラメーター名とその値を指定します。`with` 文の中で、メトリクスやその他の情報を W\&B にログできます。

```python theme={"system"}
import wandb

wandb.login()

# run の記録先となる project
project = "my-awesome-project"

# ハイパーパラメーターを格納した辞書
config = {
    'epochs' : 10,
    'lr' : 0.01
}

with wandb.init(project=project, config=config) as run:
    # ここにトレーニングコードを記述します
    # run.log() を使用して値を W&B にログします
    run.log({"accuracy": 0.9, "loss": 0.1})
```

トレーニング run をシミュレートし、精度と損失のメトリクスを W\&B にログする完全な例については、[機械学習のトレーニング実験を作成する](#create-a-machine-learning-training-experiment)を参照してください。

<Info>
  [run](/ja/products/wandb/runs) は W\&B の中核となる要素です。run を使用して、[メトリクスのトラッキング](/ja/products/wandb/track)、[ログの作成](/ja/products/wandb/track/log)、アーティファクトのトラッキングを行います。
</Info>

<h2 id="create-a-machine-learning-training-experiment">
  機械学習のトレーニング実験を作成する
</h2>

この模擬トレーニングスクリプトは、シミュレーションで生成した精度と損失のメトリクスを W\&B にログします。次のコードを Python スクリプトまたはノートブックのセルにコピー＆ペーストして実行してください。

```python theme={"system"}
import wandb
import random

wandb.login()

# run の記録先となる project
project = "my-awesome-project"

# ハイパーパラメーターの辞書
config = {
    'epochs' : 10,
    'lr' : 0.01
}

with wandb.init(project=project, config=config) as run:
    offset = random.random() / 5
    print(f"lr: {config['lr']}")

    # トレーニング run をシミュレートします
    for epoch in range(2, config['epochs']):
        acc = 1 - 2**-config['epochs'] - random.random() / config['epochs'] - offset
        loss = 2**-config['epochs'] + random.random() / config['epochs'] + offset
        print(f"epoch={config['epochs']}, accuracy={acc}, loss={loss}")
        run.log({"accuracy": acc, "loss": loss})
```

[W\&B ダッシュボード](https://forge.coreweave.com/wandb)にアクセスすると、精度や損失などの記録されたメトリクスを表示し、各トレーニングステップでの変化を確認できます。次の画像は、各 run で追跡された損失と精度を示しています。各 run オブジェクトは、自動生成された名前で **Runs** 列に表示されます。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/quickstart_image.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=bd51b523b4bce2c7009d3877740b7a96" alt="Forge のプロジェクトの Workspace。Runs 列に 7 つの run が一覧表示され、それぞれの損失と精度のチャートが表示されている" width="1152" height="653" data-path="products/wandb/_media/quickstart_image.png" />
</Frame>

<h2 id="next-steps">
  次のステップ
</h2>

W\&B のその他の機能もご覧ください。

* [run](/ja/products/wandb/runs) について学び、最初の run を作成します。
* [W\&B Artifacts](/ja/products/wandb/artifacts) を使用して、モデル、データセット、その他のファイルをトラッキングします。
* [W\&B Sweeps](/ja/products/wandb/sweeps) を使用して、ハイパーパラメーター探索を自動化し、モデルを最適化します。
* [Registry](/ja/products/registry) を使用して、モデル、プロンプト、データセットを共有します。
* project の[ダッシュボード](/ja/products/wandb/track/workspaces)で、run の分析、モデルの予測の可視化、アーティファクトの確認を行います。
* [W\&B Reports](/ja/products/wandb/reports) を使用して、分析結果をまとめ、共同作業者と最新情報を共有します。
* [W\&B Weave](/ja/products/wandb/weave/quickstart) を使用して、LLM アプリケーションのトレースと評価を行います。


## Related topics

- [Leaderboard クイックスタート](/ja/products/wandb/weave/cookbooks/leaderboard_quickstart.md)
