Interface terminal LEET - CoreWeave Docs

W&B LEET (Lightweight Experiment Exploration Tool) est une interface terminal pilotée au clavier qui permet d’explorer les runs W&B. Utilisez LEET pour comparer des métriques locales, examiner l’utilisation des ressources système, parcourir les images journalisées et suivre en continu la sortie de la console, sans ouvrir de navigateur. LEET lit les journaux de transactions .wandb locaux, ce qui vous permet d’examiner les runs avant même leur synchronisation avec le cloud. Vous pouvez également ouvrir un run distant à partir de son URL pour afficher l’historique de ses valeurs scalaires et sa synthèse.

Vue workspace de W&B LEET avec les volets des runs, des métriques, des métriques système, des médias, des journaux de console et de l’aperçu du run.

Quand utiliser LEET

LEET est conçu pour les ingénieurs qui passent l’essentiel de leur temps dans un terminal, en particulier sur des machines distantes, des clusters ou des sessions SSH où un navigateur graphique est lent, voire indisponible.

Interface	Idéal pour
LEET	Dossiers de runs locaux sur la machine qui les a journalisés ; navigation rapide au clavier ; surveillance en direct pendant qu’un job écrit encore des journaux ; flux de travail SSH et `tmux`.
W&B App	Workspaces de projet complets, collaboration en équipe, rapports, sweeps, artifacts et types de panneaux avancés pour les runs cloud synchronisés.
Application mobile W&B	Surveillance légère et alertes sur téléphone pour les projets cloud synchronisés (disponible pour le Cloud mutualisé, en préversion pour le Cloud dédié).

LEET et W&B affichent les mêmes données de run sous-jacentes dès lors que ces données sont présentes localement et ont été synchronisées. LEET prend en charge les fichiers de run locaux, les mises à jour en direct d’un processus d’entraînement en cours et une exploration limitée des runs distants.

Prérequis

Installez la CLI W&B ou mettez-la à niveau vers la dernière version avec pip ou uv :

pip install --upgrade wandb

uv pip install --upgrade wandb

Ce guide décrit le comportement de la dernière version de la CLI.

Avec le SDK v0.27.x et les versions antérieures, lancez la TUI LEET avec wandb beta leet au lieu de wandb leet.

Lancer LEET

Depuis le répertoire qui contient votre dossier wandb/, ouvrez le workspace par défaut en sélectionnant automatiquement le run local le plus récent :

wandb leet

Vous pouvez indiquer un PATH facultatif pointant vers un répertoire de workspace, le répertoire d’un run précis ou un fichier .wandb :

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

Ouvrez le moniteur système autonome (SYMON) pour afficher les métriques de l’hôte en dehors du contexte d’un run :

wandb leet symon --interval 2s

Pour la syntaxe de la commande et ses sous-commandes, consultez wandb leet dans la référence de la CLI.

Runs distants

Pour afficher un run synchronisé, indiquez son URL. Remplacez [ENTITY], [PROJECT] et [RUN-ID] par les valeurs figurant dans l’URL de votre run :

wandb leet "https://wandb.ai/[ENTITY]/[PROJECT]/runs/[RUN-ID]"

Les runs distants nécessitent une connexion réseau et une authentification par clé API auprès du serveur qui héberge le run. LEET utilise vos identifiants configurés ou vous invite à vous connecter. Le mode distant ouvre l’historique scalaire et la synthèse d’un seul run. Il ne prend pas en charge les mises à jour en direct, la comparaison de plusieurs runs, la configuration, les métriques système, les médias, les journaux de console, les axes X personnalisés ni l’inspecteur d’enregistrements. Pour ces fonctionnalités, utilisez des fichiers de run locaux.

Vues et mise en page des volets

LEET propose trois vues principales : workspace, run unique et SYMON. L’inspecteur d’enregistrements fournit une vue distincte d’un journal de transactions local.

Vue workspace

La vue workspace est la vue par défaut. Elle permet de comparer plusieurs runs issus du même répertoire local wandb/. Les volets habituels sont les suivants :

Barre latérale Runs — parcourez et filtrez les dossiers de runs locaux.
Grille de métriques — superposez les runs sélectionnés sur les mêmes graphiques scalaires.
Métriques système — graphiques du run en surbrillance.
Médias — miniatures wandb.Image rendues dans le terminal.
Journaux de console — sorties stdout et stderr regroupées du run en surbrillance.
Aperçu du run — état, ID, tags, notes, configuration et valeurs de synthèse.

Utilisez space pour sélectionner ou désélectionner un run et superposer ses métriques. Les runs sélectionnés sont signalés par une icône pleine. Utilisez p pour épingler un run afin que sa série reste au premier plan dans les graphiques de métriques. Appuyez sur enter sur le run en surbrillance pour ouvrir la vue run unique. Les runs en cours continuent de se mettre à jour dans le workspace : vous pouvez donc utiliser LEET aussi bien pour l’analyse a posteriori que pour la surveillance d’un job actif. Les runs en cours sont signalés par des marqueurs animés dans la liste des runs et par un indicateur d’état clignotant dans la barre de statut. LEET marque un run local en cours comme planté après 10 minutes sans mise à jour du journal de transactions. Si les écritures reprennent, LEET reprend la surveillance en direct. Dans les terminaux étroits, LEET masque temporairement la barre latérale d’aperçu du run, puis la barre latérale des runs, afin de laisser si possible au moins 24 colonnes aux graphiques. Les barres latérales réapparaissent dès que le terminal dispose de suffisamment d’espace.

Vue run unique

La vue run unique est centrée sur un seul run : une grille de métriques occupe le centre, l’aperçu du run se trouve à gauche et les métriques système à droite. Une fois activés, les volets des médias et des journaux de la console s’ouvrent sous la grille de métriques.

Appuyez sur esc pour quitter le filtre actif ou la vue des médias en plein écran, puis pour retirer le focus du volet. Pour un run local, appuyez de nouveau sur esc lorsqu’aucun volet n’a le focus pour revenir à la vue workspace.

SYMON

SYMON surveille les métriques locales du CPU, de la mémoire, du disque, du réseau et des accélérateurs. Il utilise le même moteur de graphiques que les volets de métriques système associés à un run, mais ne dépend d’aucun fichier de run W&B.

Vue des métriques système de W&B LEET avec des graphiques GPU en mode carte thermique par buckets.

Inspecteur d’enregistrements

Utilisez l’inspecteur d’enregistrements pour examiner les enregistrements bruts d’un journal de transactions .wandb local. Dans la vue run unique, appuyez sur i pour l’ouvrir sur le run actuel. Vous pouvez également le lancer directement :

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

Le chemin facultatif accepte un fichier .wandb, un répertoire de run ou un répertoire de workspace. Sans chemin, ou avec un répertoire de workspace, LEET ouvre le run le plus récent. La liste des enregistrements affiche le type et la synthèse de chaque enregistrement, ainsi que le texte complet de l’enregistrement sélectionné. Appuyez sur / pour filtrer par type ou par synthèse, sur tab pour basculer entre les modes regex et glob pendant la saisie, et sur ctrl+/ pour effacer le filtre. Lorsque la liste des enregistrements a le focus, appuyez sur end pour suivre en direct les nouveaux enregistrements d’un run en cours. Si vous avez ouvert l’inspecteur avec i, appuyez sur esc depuis la liste des enregistrements pour revenir au run. Lorsque stdout est redirigé vers un pipe ou un fichier, la commande affiche les enregistrements disponibles au format texte Protocol Buffer, puis se termine :

wandb leet inspect | less
wandb leet inspect > records.txt

Fonctionnalités clés

Comparaison de plusieurs runs

Sélectionnez plusieurs runs dans la vue workspace pour comparer des métriques scalaires sur des graphiques partagés. Chaque run se voit attribuer une couleur stable, et LEET limite les collisions entre couleurs de base afin que les séries superposées restent faciles à distinguer. L’épinglage est utile lorsque de nombreux runs sont sélectionnés et que vous souhaitez afficher une série au-dessus des autres. Appuyez sur f pour filtrer la liste des runs par nom, projet, tags, notes, valeurs de configuration et autres métadonnées. Les termes simples sont recherchés dans la clé du run, le nom d’affichage, l’ID du run, le projet, les tags et les notes. Le filtre prend également en charge les requêtes par champ :

Requête	Correspondance
`project:vision`	Nom du projet.
`name:baseline`	Nom d’affichage. Alias : `run_name`, `display`, `display_name`.
`id:abc123`	ID du run. Alias : `run_id`.
`key:offline-run`	Clé du répertoire du run. Alias : `run_key`, `path`.
`tag:prod`	Tags. Alias : `tags`.
`note:debug`	Notes. Alias : `notes`.
`config:adamw` ou `cfg:adamw`	N’importe quelle clé ou valeur de configuration aplatie.
`cfg.lr>=1e-3`	Un chemin de configuration imbriqué précis. `config.lr` fonctionne également.
`has:notes` ou `exists:cfg.dataset`	Vérification d’existence.

Les opérateurs pris en charge sont :, =, !=, >, >=, < et <=. Les comparaisons numériques sont utiles pour des valeurs de configuration telles que le taux d’apprentissage, la taille de lot ou le nombre de couches. Utilisez un espace ou AND pour combiner des conditions, OR ou | pour les alternatives, et -, ! ou NOT pour la négation. Placez entre guillemets les expressions contenant des espaces.

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

Lorsque vous modifiez un filtre, appuyez sur tab pour basculer entre les modes regex et glob. Le mode regex se comporte comme une recherche de sous-chaîne insensible à la casse, sauf si la requête contient des métacaractères regex. Le mode glob prend en charge * pour représenter n’importe quelle séquence de caractères et ? pour représenter un seul caractère quelconque. LEET enregistre les filtres de runs, de métriques et de métriques système, y compris leurs modes de correspondance, dans le fichier .wandb-leet.json de chaque répertoire local wandb/. Il les restaure lorsque vous rouvrez ce répertoire dans la vue workspace ou la vue run unique. Effacer un filtre supprime également sa valeur enregistrée. Les filtres du journal de la console et de l’aperçu du run ne sont pas conservés d’une session à l’autre.

Métriques et métriques système

LEET affiche les métriques scalaires sous forme de graphiques linéaires dans le terminal. Filtrez les métriques de run avec / et les métriques système avec \. Lorsque le volet des journaux de la console a le focus, / filtre plutôt les journaux. Appuyez sur y sur un graphique actif pour passer d’un mode à l’autre, par exemple l’axe Y en échelle logarithmique ou la vue en carte thermique par buckets pour les métriques système exprimées en pourcentage. Appuyez sur g pour alterner les repères des graphiques entre désactivés, un arrière-plan en pointillés et des lignes horizontales alignées sur les graduations de l’axe Y. Ce paramètre s’applique aux vues workspace, run unique et SYMON, et il est conservé d’une session à l’autre. Par défaut, LEET trace chaque métrique en fonction de la métrique de step interne de W&B (_step). Pour les runs locaux, un axe X personnalisé défini avec run.define_metric() est prioritaire, y compris lorsque sa définition utilise des motifs glob. Par exemple, ce run trace train/loss en fonction de train/step :

import wandb

with wandb.init(project="leet-example", mode="offline") as run:
    run.define_metric("train/*", step_metric="train/step")
    for step in range(10):
        run.log({"train/step": step * 100, "train/loss": 1 / (step + 1)})

L’en-tête du graphique et la barre d’état affichent [x: train/step]. Les lignes sans valeur finie pour l’axe X personnalisé sont omises. Chaque graphique utilise un seul axe X ; comparez donc des runs partageant la même définition d’axe. Un axe personnalisé remplace l’axe step par défaut, et les séries utilisant un autre axe ne sont pas tracées sur ce graphique. Utilisez la molette de la souris pour zoomer sur le graphique actif. Sur les graphiques de métriques système en direct, LEET affiche par défaut une fenêtre glissante des données les plus récentes (10 minutes par défaut). Cliquez avec le bouton droit et faites glisser sur un graphique pour inspecter le point le plus proche. Maintenez alt enfoncé pendant le glissement pour inspecter, à la même position X, les graphiques visibles de la même grille. Les graphiques de métriques ne se synchronisent que s’ils partagent le même axe X.

Médias et journaux de la console

Le volet multimédia affiche les séries wandb.Image, y compris les listes d’images journalisées sous une même clé, à raison d’une vignette par image. Affichez-le ou masquez-le avec 3 dans la vue workspace ou la vue run unique. Lorsque le volet multimédia a le focus, utilisez w, a, s et d pour sélectionner des vignettes. Les flèches gauche et droite permettent de se déplacer d’une image multimédia, et les flèches haut et bas de 10 images multimédias. Appuyez sur enter pour afficher le média en plein écran et sur esc pour quitter ce mode. Appuyez sur l pour synchroniser le défilement des séries d’images : les flèches, home et end déplacent alors un curseur commun le long de leur chronologie de steps combinée. Appuyez sur k pour basculer entre les miniatures ANSI et le rendu haute résolution dans les terminaux qui prennent en charge le protocole graphique Kitty. Si le terminal ne prend pas en charge le rendu haute résolution, LEET repasse en ANSI. La marge autour des images reprend l’arrière-plan du terminal.

Vue workspace de W&B LEET avec le volet multimédia affichant plusieurs séries d’images.

Affichez ou masquez les journaux de la console avec 4. LEET reconstruit des lignes de journal lisibles à partir de la sortie brute du terminal, y compris les séquences d’échappement ANSI et les lignes de progression utilisant le retour chariot. Pour filtrer la sortie de la console, placez le focus sur le volet des journaux, appuyez sur / et saisissez un motif. Pendant la saisie, appuyez sur tab pour basculer entre la correspondance par regex et par glob. Appuyez sur enter pour appliquer le filtre ou sur esc pour abandonner la requête en cours de saisie. LEET affiche les lignes correspondantes et suit les nouvelles correspondances lorsque vous êtes à la fin du journal. Lorsque le volet des journaux a le focus, appuyez sur ctrl+/ ou ctrl+l pour effacer le filtre. Pour en savoir plus sur le comportement des journaux de la console dans la W&B App, consultez Journaux de la console.

Configuration

Enregistrez la mise en page, les couleurs, les volets par défaut et le mode de démarrage à l’aide de l’éditeur de configuration :

wandb leet config

Par défaut, LEET écrit wandb-leet.json dans ~/.config/wandb/, ou dans WANDB_CONFIG_DIR lorsque cette variable est définie. Vous pouvez également redimensionner les grilles directement dans LEET avec c et r. Faites glisser les bordures des volets et les lignes de séparation pour redimensionner les barres latérales, les volets empilés ainsi que les sections Environment, Config et Summary de l’aperçu du run. La bordure active est mise en surbrillance pendant le glissement. LEET enregistre les proportions séparément pour les vues workspace, run unique et inspecteur. Appuyez sur 0 pour réinitialiser les tailles de la vue actuelle, y compris celles des sections de l’aperçu du run. Dans l’éditeur de configuration, la liste des champs défile pour suivre votre sélection, ce qui permet de l’utiliser dans les terminaux de faible hauteur. Appuyez sur space pour activer ou désactiver un paramètre booléen.

Éditeur de configuration de W&B LEET affichant les paramètres de grille, les jeux de couleurs, les paramètres de visibilité et la sélection de palette.

Clés de configuration courantes

Clé	Par défaut	Description
`startup_mode`	`workspace_latest`	Vue initiale lors d’un lancement sans chemin du run.
`chart_guides`	`off`	Repères des graphiques linéaires : `off`, `dots` ou `horizontal`. Faites défiler les options avec `g`.
`metrics_grid.rows`, `metrics_grid.cols`	`4`, `3`	Taille de la grille des métriques en vue run unique.
`system_grid.rows`, `system_grid.cols`	`6`, `2`	Taille de la grille de la barre latérale des métriques système en vue run unique.
`media_grid.rows`, `media_grid.cols`	`1`, `2`	Taille de la grille multimédia en vue run unique.
`workspace_metrics_grid.rows`, `workspace_metrics_grid.cols`	`3`, `3`	Taille de la grille des métriques du workspace.
`workspace_system_grid.rows`, `workspace_system_grid.cols`	`3`, `3`	Taille de la grille des métriques système du workspace.
`workspace_media_grid.rows`, `workspace_media_grid.cols`	`1`, `2`	Taille de la grille multimédia du workspace.
`symon_grid.rows`, `symon_grid.cols`	`3`, `3`	Taille de la grille SYMON.
`color_scheme`	`wandb-vibe-10`	Palette des métriques des runs du workspace et des couleurs de la liste des runs.
`per_plot_color_scheme`	`sunset-glow`	Palette des graphiques en vue run unique lorsque `single_run_color_mode` vaut `per_plot`.
`tag_color_scheme`	`wandb-vibe-10`	Palette des badges de tags dans la barre latérale d’aperçu.
`system_color_scheme`	`wandb-vibe-10`	Palette des graphiques de métriques système.
`french_fries_color_scheme`	`viridis`	Palette des graphiques de type carte thermique par buckets.
`single_run_color_mode`	`per_series`	Colore les graphiques en vue run unique par série ou par graphique.
`system_color_mode`	`per_series`	Colore les graphiques système par série ou par graphique.
`system_tail_window_minutes`	`10`	Fenêtre glissante par défaut des données en direct pour les graphiques système.
`heartbeat_interval_seconds`	`15`	Intervalle d’interrogation (heartbeat) des runs en cours.
`workspace_overview_visible`	`true`	Affiche par défaut la barre latérale d’aperçu des runs du workspace.
`workspace_metrics_grid_visible`	`true`	Affiche par défaut la grille des métriques du workspace.
`workspace_system_metrics_visible`	`false`	Affiche par défaut le volet des métriques système du workspace.
`workspace_console_logs_visible`	`false`	Affiche par défaut le volet des journaux de la console du workspace.
`workspace_media_visible`	`false`	Affiche par défaut le volet multimédia du workspace.
`left_sidebar_visible`	`true`	Affiche par défaut la barre latérale d’aperçu en vue run unique.
`right_sidebar_visible`	`true`	Affiche par défaut la barre latérale des métriques système en vue run unique.
`metrics_grid_visible`	`true`	Affiche par défaut la grille des métriques en vue run unique.
`console_logs_visible`	`false`	Affiche par défaut le volet des journaux de la console en vue run unique.
`media_visible`	`false`	Affiche par défaut le volet multimédia en vue run unique.

Plusieurs palettes de couleurs sont disponibles, notamment wandb-vibe-10, wandb-vibe-20, sunset-glow, blush-tide, gilded-lagoon, bootstrap-vibe, dusk-shore, clear-signal, traffic-light, viridis, plasma, inferno, magma et cividis.

Les palettes dusk-shore et clear-signal sont adaptées aux personnes daltoniennes.
Les palettes séquentielles telles que viridis, plasma, inferno, magma, cividis et traffic-light conviennent particulièrement aux cartes thermiques par buckets.

Diagnostics et télémétrie

LEET affiche les erreurs de démarrage sur stderr. Pour collecter les journaux de débogage, lancez-le avec WANDB_DEBUG=true :

WANDB_DEBUG=true wandb leet

La sortie de débogage est écrite dans wandb-leet.debug.log, à côté du fichier de configuration global wandb-leet.json. LEET n’envoie aucune donnée de télémétrie d’utilisation lorsque WANDB_MODE=offline, WANDB_MODE=disabled ou WANDB_ERROR_REPORTING=false est défini.

Naviguer au clavier

LEET est conçu pour être utilisé au clavier et à la souris. Appuyez sur h ou ? dans LEET pour ouvrir l’aide intégrée, affichée en superposition, de la vue actuelle. Dans les vues workspace et run unique :

tab et shift+tab font passer le focus d’un volet visible à l’autre.
w, a, s, d et les touches fléchées permettent de se déplacer dans le volet actif (sauf dans le volet multimédia, où les flèches font défiler l’axe X et WASD permet de passer d’une vignette à l’autre).
home, end, pgup et pgdown permettent d’accéder directement à une position dans les listes, les pages de graphiques ou les images multimédias.
1, 2, 3 et 4 affichent ou masquent respectivement les volets de la grille des métriques, des métriques système, multimédia et des journaux de la console.
[ et ] affichent ou masquent les barres latérales (liste des runs, aperçu du run ou métriques système, selon la vue).

Pour consulter les tableaux complets des raccourcis des vues workspace, run unique, SYMON, multimédia, de l’inspecteur d’enregistrements et des actions de la souris, voir Raccourcis clavier (onglet LEET).

Limitations par rapport à la W&B App

LEET complète la W&B App, mais ne reproduit pas toutes les fonctionnalités du workspace.

Fonctionnalité	LEET	W&B App
Source de données	Répertoires `wandb/` et fichiers `.wandb` locaux, ou historique scalaire et synthèse d’un run distant via son URL	Projets cloud et équipes synchronisés
Comparaison de runs	Plusieurs runs locaux dans un même répertoire	Tableaux complets du workspace, regroupement et vues enregistrées
Types de panneaux	Graphiques linéaires scalaires, métriques système, médias `wandb.Image`, journaux de console	Graphiques linéaires, histogrammes, nuages de points, coordonnées parallèles, médias, code, panneaux de requête, graphiques personnalisés, etc.
Collaboration	Session de terminal mono-utilisateur	Partage, commentaires, rapports et fonctionnalités d’équipe
Artifacts et fichiers	Non disponible	Onglets Artifacts, Files et Code pour chaque run
Sweeps et registre	Non disponible	Tableaux de bord de sweeps, registre et automatisations

Si vous avez besoin d’artifacts, d’analyses de sweeps ou de types de panneaux que LEET ne propose pas, ouvrez le run dans la W&B App une fois la synchronisation effectuée.

Journal des modifications

LEET a d’abord été lancé en version bêta dans le SDK v0.23.0, puis est passé en disponibilité générale (GA) dans le SDK v0.28.0. Pour plus de détails, référez-vous aux notes de version du SDK.

Afficher un run spécifique dans la W&B App ou dans LEET.
Raccourcis clavier de la W&B App et de LEET.
Référence de la commande wandb leet.
Notes de version du SDK, y compris les modifications apportées à LEET.

​Quand utiliser LEET

​Prérequis

​Lancer LEET

​Runs distants

​Vues et mise en page des volets

​Vue workspace

​Vue run unique

​SYMON

​Inspecteur d’enregistrements

​Fonctionnalités clés

​Comparaison de plusieurs runs

​Métriques et métriques système

​Médias et journaux de la console

​Configuration

​Clés de configuration courantes

​Diagnostics et télémétrie

​Naviguer au clavier

​Limitations par rapport à la W&B App

​Journal des modifications

​Ressources associées

Quand utiliser LEET

Prérequis

Lancer LEET

Runs distants

Vues et mise en page des volets

Vue workspace

Vue run unique

SYMON

Inspecteur d’enregistrements

Fonctionnalités clés

Comparaison de plusieurs runs

Métriques et métriques système

Médias et journaux de la console

Configuration

Clés de configuration courantes

Diagnostics et télémétrie

Naviguer au clavier

Limitations par rapport à la W&B App

Journal des modifications

Ressources associées