.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, ou afficher l’état d’un run depuis un script avec wandb leet inspect --summary.

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.
LEET et Weights & Biases 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 avecpip ou uv :
- pip
- uv
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 dossierwandb/, ouvrez le workspace. LEET sélectionne les runs que vous aviez sélectionnés lors de la dernière ouverture de ce répertoire, ainsi que le run le plus récent s’il a démarré entre-temps :
PATH facultatif pointant vers un répertoire de workspace, le répertoire d’un run précis ou un fichier .wandb :
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.ai, ainsi que des déploiements Cloud dédié et autogérés. 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 localwandb/.
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.Imagerendues 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.
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.
Appuyez sur ctrl+a pour sélectionner tous les runs qui correspondent au filtre des runs. La barre de statut indique le nombre de runs que LEET va charger. Appuyez sur y pour confirmer ou sur esc pour annuler. Appuyez sur x pour désélectionner tous les runs, à l’exception du run épinglé.
LEET mémorise les runs sélectionnés et épinglés de chaque répertoire wandb/ dans .wandb-leet.json et les resélectionne à la prochaine ouverture. Il sélectionne également le run le plus récent si celui-ci a démarré après votre dernière session, ou si aucun run mémorisé n’est sélectionné.
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. Un processus en cours d’exécution écrit ses données dans le fichier .wandb au moins toutes les 15 secondes : LEET affiche donc les nouvelles valeurs dans ce délai, même pour les runs qui journalisent rarement. 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.
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.
t pour les trier plutôt par mémoire, sur f pour les filtrer par nom ou PID, et sur ctrl+f pour effacer le filtre. Les touches tab et shift+tab déplacent le focus entre la liste des processus et les graphiques. Appuyez sur [ pour masquer ou afficher la barre latérale, faites glisser sa bordure pour la redimensionner, et appuyez sur 0 pour restaurer la largeur par défaut. LEET enregistre la visibilité et la largeur de la barre latérale d’une session à l’autre.
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, 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.
Pour vérifier l’état d’un run depuis un script ou un agent de développement, affichez une synthèse au lieu d’ouvrir l’inspecteur :
--json, elle se présente sous la forme d’un seul objet JSON.
Lorsque stdout est redirigé vers un pipe ou un fichier, ou avec --json, la commande affiche plutôt les enregistrements : au format texte Protocol Buffer, ou sous la forme d’un objet JSON par ligne contenant le numéro de l’enregistrement, son type et sa charge utile décodée. --follow continue d’afficher les enregistrements au fur et à mesure qu’un run en cours les écrit, et s’arrête lorsque le run se termine ou après 10 minutes sans écriture. Définissez --idle-timeout pour modifier ce délai d’attente, par exemple --idle-timeout 30s, ou 0 pour attendre indéfiniment :
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 surf 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 :
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.
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, ainsi que les runs sélectionnés et épinglés, 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. Le graphique CPU Core (%), qui comporte une série par cœur, s’ouvre sous forme de carte de chaleur avec une ligne par cœur. Appuyez sur y pour l’afficher sous forme de lignes.
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 Weights & Biases (_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 :
[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érieswandb.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.

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.
Dans la vue run unique, lorsque le volet des journaux a le focus, appuyez sur l pour lier les journaux de la console aux graphiques. Les graphiques affichent alors un réticule correspondant à l’instant où la ligne sélectionnée a été journalisée : à cet instant précis pour les graphiques de métriques système, et au step d’historique journalisé le plus proche pour les graphiques de métriques. Lorsque vous inspectez un graphique avec la souris, la ligne de console journalisée la plus proche du point inspecté est sélectionnée. Les graphiques de métriques dotés d’un axe X personnalisé ne sont pas liés. Appuyez de nouveau sur l pour supprimer le lien.
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.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.

Clés de configuration courantes
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-shoreetclear-signalsont adaptées aux personnes daltoniennes. - Les palettes séquentielles telles que
viridis,plasma,inferno,magma,cividisettraffic-lightconviennent 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 avecWANDB_DEBUG=true :
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 surh 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 :
tabetshift+tabfont passer le focus d’un volet visible à l’autre.w,a,s,det 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,pgupetpgdownpermettent d’accéder directement à une position dans les listes, les pages de graphiques ou les images multimédias.1,2,3et4affichent 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).
Limitations par rapport à la W&B App
LEET complète la W&B App, mais ne reproduit pas toutes les fonctionnalités du workspace.
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.Ressources associées
- 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.