LEET ターミナル UI

LEET（Lightweight Experiment Exploration Tool）TUI を使用して、ターミナルからローカルの W&B Runs を探索、比較できます。

W&B LEET (Lightweight Experiment Exploration Tool) は、作業中のマシンにログされた Runs を探索するための、キーボード操作中心のターミナル UI です。LEET を使用すると、ブラウザーを開かずに、メトリクスの比較、システム使用状況の確認、ログされた画像の参照、コンソール出力の追跡を行えます。LEET はローカルの .wandb トランザクションログを読み取るため、Runs がクラウドに同期される前でも確認できます。

​

LEET を使用するタイミング

LEET は、作業時間の大半をターミナルで過ごすエンジニア向けに作られています。特に、グラフィカルブラウザーの動作が遅い、または利用できないリモートマシン、クラスター、SSH セッションでの利用に適しています。

Surface	Best for
LEET	ログを記録したマシン上のローカル run フォルダー、高速なキーボード操作、ジョブがまだログを書き込んでいる間のライブモニタリング、SSH や tmux のワークフロー。
W&B App	project 全体のWorkspace、チームコラボレーション、Reports、Sweeps、Artifacts、同期済みクラウド Runs 全体にわたる豊富なパネルタイプ。
W&B mobile app	スマートフォンで同期済みクラウド Projects を軽量にモニタリングし、アラートを確認する用途 (Multi-tenant Cloud のみ) 。

LEET と W&B App は、データがローカルに存在し、かつ同期されている場合、同じ基盤となる run データを表示します。LEET はブラウザー上の project Workspaceを置き換えるものではありません。ローカルの run ファイルと、アクティブなトレーニング プロセスからのライブ更新に対応する別のインターフェイスです。

​

事前準備

pip または uv を使用して、W&B CLI を最新バージョンにインストールまたはアップグレードします。

pip

pip install --upgrade wandb

uv

uv pip install --upgrade wandb

このガイドは、最新の CLI の動作に基づいています。バージョンごとの変更については、このページの changelog を参照してください。

SDK v0.27.x 以前では、LEET TUI の起動には wandb leet ではなく wandb beta leet を使用してください。

​

Launch LEET

wandb/ フォルダを含むディレクトリから、デフォルトのWorkspaceを開き、最新のローカル run を自動的に選択します:

wandb leet

Workspace ディレクトリ、特定の run ディレクトリ、または .wandb file を指す任意の PATH を渡せます：

wandb leet ./wandb
wandb leet ./wandb/offline-run-20260403_145048-6ao9fhns
wandb leet ./wandb/offline-run-20260403_145048-6ao9fhns/run-6ao9fhns.wandb

ホストのメトリクスをrun コンテキストなしで表示するには、スタンドアロンのシステムモニター (SYMON) を開きます。

wandb leet symon --interval 2s

コマンド構文とサブコマンドについては、CLI リファレンスの wandb leet をご覧ください。

​

ビューとペインのレイアウト

LEET には、Workspace、単一 run、SYMON の 3 つの主要ビューがあります。

​

Workspace ビュー

Workspace ビューはデフォルトのビューです。同じローカル wandb/ ディレクトリ内の複数の Runs を比較するように設計されています。

代表的なペインは次のとおりです。

• Runs サイドバー — ローカルの run フォルダーを参照し、フィルターします。
• メトリクス グリッド — 選択した Runs を同じスカラー チャート上に重ねて表示します。
• システムメトリクス — ハイライトされた run のチャートです。
• メディア — ターミナルにレンダリングされる wandb.Image のサムネイルです。
• コンソールログ — ハイライトされた run の stdout と stderr をまとめて表示します。
• Run overview — state、IDs、タグ、メモ、設定、サマリー値を表示します。

重ね合わせ表示するメトリクスの対象として、space で run を選択または選択解除します。選択された Runs には塗りつぶしアイコンが表示されます。p を使用して run をピン留めすると、その系列がメトリクス チャートの前面に固定されます。ハイライトされた run で enter を押すと、単一 run ビュー が開きます。実行中の run は Workspace 内で更新され続けるため、LEET は run 後の分析にも、アクティブなジョブのモニタリングにも使用できます。

​

単一 run ビュー

単一 run ビューでは、1 つの run にフォーカスし、中央にメトリクスグリッド、左側に run overview、右側にシステムメトリクスが表示されます。切り替えてオンにすると、メディアペインとコンソールログペインがメトリクスグリッドの下に表示されます。

esc を押すと Workspace ビューに戻ります。

​

SYMON

SYMON は、ローカルの CPU、メモリ、ディスク、ネットワーク、アクセラレータのメトリクスを監視します。W&B Run に紐づくシステムメトリクス ペインと同じチャート エンジンを使用しますが、W&B Run の file には関連付けられていません。

​

主な機能

​

複数 run の比較

Workspace ビューで複数の run を選択すると、共有チャート上でスカラー メトリクスを比較できます。各 run には一貫した色が割り当てられ、LEET はベース色の競合を減らすことで、重ねて表示した系列を見分けやすくします。多数の run を選択していて、1 つの系列をほかの系列より前面に表示したい場合は、ピン留めが便利です。

f を押すと、名前、project、タグ、メモ、設定値、そのほかのメタデータで Runs リストをフィルターできます。修飾子のない検索語は、run key、表示名、Run ID、project、タグ、メモを対象に検索されます。フィルターはフィールド指定クエリもサポートします。

Query	一致対象
project:vision	プロジェクト名。
name:baseline	表示名。エイリアス: run_name, display, display_name。
id:abc123	Run ID。エイリアス: run_id。
key:offline-run	run ディレクトリ key。エイリアス: run_key, path。
tag:prod	タグ。エイリアス: tags。
note:debug	メモ。エイリアス: notes。
config:adamw or cfg:adamw	フラット化された任意の設定 key または値。
cfg.lr>=1e-3	特定のネストされた設定パス。config.lr も使用できます。
has:notes or exists:cfg.dataset	存在チェック。

サポートされる演算子は :, =, !=, >, >=, <, <= です。数値比較は、学習率、バッチサイズ、レイヤー数などの設定値に便利です。

AND 条件には空白または AND、代替条件には OR または |、否定には -、!、または NOT を使用します。空白を含むフレーズには引用符を使用します。

transformer
project:vision tag:baseline
cfg.lr>=1e-3 cfg.optimizer=adamw
has:notes -tag:debug
project:vision tag:baseline cfg.lr>=1e-3 -note:debug | project:nlp

フィルターの編集中に tab を押すと、regex モードと glob モードを切り替えられます。Regex モードは、クエリに regex のメタ文字が含まれていない限り、大文字と小文字を区別しない部分文字列検索のように動作します。Glob モードでは、* は任意の文字列、? は任意の 1 文字を表します。

​

メトリクスとシステムメトリクス

LEET は、スカラー メトリクスをターミナルの折れ線チャートとして表示します。/ で run のメトリクスをフィルターし、\ でシステムメトリクスをフィルターします。フォーカスしたチャートで y を押すと、Y 軸の対数スケールや、割合ベースのシステムメトリクス向けのバケット化ヒートマップ表示などのモードを切り替えられます。

マウス ホイールを使用して、フォーカスしたチャートをズームします。ライブのシステムメトリクス チャートでは、LEET はデフォルトでローリング テール ウィンドウ (既定では 10 分) を使用します。チャート上で右クリックしたままドラッグすると、最も近いポイントを確認できます。alt を押しながらドラッグすると、同じ X 位置にある表示中のすべてのチャートを確認できます。

​

メディアとコンソールログ

メディアペインには、wandb.Image シリーズが ANSI サムネイルとして表示されます。Workspace または単一 run ビューで 3 を押すと表示を切り替えられます。

4 を押すとコンソールログの表示を切り替えられます。LEET は、ANSI エスケープコードやキャリッジリターンによる進捗行を含む生のターミナル出力から、読みやすいログ行を再構成します。

W&B App でのコンソールログの動作については、Console logs を参照してください。

​

設定

設定エディタを使用すると、レイアウト、カラー、デフォルトのペイン、起動モードを保存できます。

wandb leet config

LEET はデフォルトで wandb-leet.json を ~/.config/wandb/ 配下に書き込みます。変数 WANDB_CONFIG_DIR が設定されている場合は、その配下に書き込みます。LEET 内では、c と r を使ってグリッドのサイズを変更することもできます。

​

一般的な設定キー

キー	デフォルト	説明
startup_mode	workspace_latest	run パスを指定せずに起動した場合の初期ビュー。
metrics_grid.rows, metrics_grid.cols	4, 3	単一 run メトリクスグリッドのサイズ。
system_grid.rows, system_grid.cols	6, 2	単一 run システムメトリクスサイドバーのグリッドサイズ。
media_grid.rows, media_grid.cols	1, 2	単一 run メディアグリッドのサイズ。
workspace_metrics_grid.rows, workspace_metrics_grid.cols	3, 3	Workspace メトリクスグリッドのサイズ。
workspace_system_grid.rows, workspace_system_grid.cols	3, 3	Workspace システムメトリクスグリッドのサイズ。
workspace_media_grid.rows, workspace_media_grid.cols	1, 2	Workspace メディアグリッドのサイズ。
symon_grid.rows, symon_grid.cols	3, 3	SYMON グリッドのサイズ。
color_scheme	wandb-vibe-10	Workspace の run メトリクスと run リストのカラーに使用するパレット。
per_plot_color_scheme	sunset-glow	single_run_color_mode が per_plot の場合に使用する 単一 run チャートのパレット。
tag_color_scheme	wandb-vibe-10	概要サイドバー内のタグバッジに使用するパレット。
system_color_scheme	wandb-vibe-10	システムメトリクスチャートに使用するパレット。
french_fries_color_scheme	viridis	バケット化ヒートマップチャートに使用するパレット。
single_run_color_mode	per_series	単一 run チャートを系列ごとに色分けするか、プロットごとに色分けするかを指定します。
system_color_mode	per_series	システムチャートを系列ごとに色分けするか、プロットごとに色分けするかを指定します。
system_tail_window_minutes	10	システムチャートのデフォルトのライブテールウィンドウ。
heartbeat_interval_seconds	15	ライブ run のポーリング間隔。
workspace_overview_visible	true	Workspace の run 概要サイドバーをデフォルトで表示します。
workspace_metrics_grid_visible	true	Workspace メトリクスグリッドをデフォルトで表示します。
workspace_system_metrics_visible	false	Workspace システムメトリクスペインをデフォルトで表示します。
workspace_console_logs_visible	false	Workspace のコンソールログペインをデフォルトで表示します。
workspace_media_visible	false	Workspace メディアペインをデフォルトで表示します。
left_sidebar_visible	true	単一 run 概要サイドバーをデフォルトで表示します。
right_sidebar_visible	true	単一 run システムメトリクスサイドバーをデフォルトで表示します。
metrics_grid_visible	true	単一 run メトリクスグリッドをデフォルトで表示します。
console_logs_visible	false	単一 run のコンソールログペインをデフォルトで表示します。
media_visible	false	単一 run メディアペインをデフォルトで表示します。

wandb-vibe-10、wandb-vibe-20、sunset-glow、blush-tide、gilded-lagoon、bootstrap-vibe、dusk-shore、clear-signal、traffic-light、viridis、plasma、inferno、magma、cividis など、複数のカラースキームを利用できます。

• dusk-shore と clear-signal のパレットは、色覚多様性に配慮しています。
• viridis、plasma、inferno、magma、cividis、traffic-light などの連続パレットは、バケット化ヒートマップに適しています。

​

キーボードで操作する

LEET は、キーボードとマウスでの操作向けに設計されています。LEET 内で h または ? を押すと、現在のビューに対応するアプリ内ヘルプのオーバーレイが開きます。

Workspace と単一 run ビューでは、次の操作が共通です。

• tab と shift+tab で、表示されているペイン間を順番にフォーカス移動します。
• w、a、s、d と矢印キーで、フォーカス中のペイン内を移動します (ただし media pane では、矢印キーで X-axis をスクラブし、WASD でタイル間を移動します) 。
• home、end、pgup、pgdown で、リスト、チャートページ、またはメディアフレーム内を移動します。
• 1、2、3、4 で、メトリクスグリッド、システムメトリクス、メディア、コンソールログ pane の表示を切り替えます。
• [ と ] で、サイドバー (ビューに応じて Runs リスト、run overview、またはシステムメトリクス) の表示を切り替えます。

Workspace、単一 run、SYMON、およびマウス操作の完全なショートカット表については、Keyboard shortcuts (LEET タブ) を参照してください。

​

W&B App と比較した場合の制限事項

LEET は W&B App を補完するものですが、Workspace のすべての機能を再現するわけではありません。

機能	LEET	W&B App
データソース	現在のマシン上にあるローカルの wandb/ ディレクトリと .wandb file	同期済みのクラウド Projects と Teams
Runs の比較	1 つのディレクトリ内の複数のローカル Runs	完全な Workspace の表、Grouping、保存済みビュー
パネル タイプ	スカラーの折れ線チャート、システムメトリクス、wandb.Image メディア、コンソールログ	折れ線、棒、散布図、平行座標、メディア、Code、クエリ パネル、カスタム チャート など
コラボレーション	1 人のユーザーによるターミナル セッション	共有、コメント、Reports、チーム機能
Artifacts と file	利用不可	Run ごとの Artifacts、Files、Code タブ
Sweeps と Registry	利用不可	sweep ダッシュボード、Registry、オートメーション

LEET で提供されていない Artifacts、sweep 分析、またはパネル タイプが必要な場合は、同期後に W&B App で Run を開いてください。

​

変更履歴

LEET は SDK v0.23.0 で初めてベータ版として公開され、SDK v0.28.0 で GA に移行しました。詳細については、SDK リリースノートを参照してください。

​

関連リソース

• W&B App または LEET で特定の run を表示。
• W&B App と LEET のキーボード ショートカット。
• wandb leet のコマンド リファレンス。
• LEET の変更を含む SDK リリースノート。