> ## 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. # Interface terminal LEET > Explorez les runs W&B locaux et les métriques de runs distants depuis le terminal grâce à l’interface terminal LEET. 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.

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](/fr/products/wandb/runs/view-logged-runs)** | 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](/fr/products/wandb/platform/hosting/monitoring-usage/mobile-app)** | 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](#remote-runs).

Prérequis

Installez la CLI W\&B ou mettez-la à niveau vers la dernière version avec `pip` ou `uv` : ```sh theme={"system"} pip install --upgrade wandb ``` ```sh theme={"system"} 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 : ```sh theme={"system"} 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` : ```sh theme={"system"} 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 : ```sh theme={"system"} wandb leet symon --interval 2s ``` Pour la syntaxe de la commande et ses sous-commandes, consultez [`wandb leet`](/fr/products/wandb/ref/cli/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 : ```sh theme={"system"} 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. Vue run unique de W&B LEET avec les volets d’aperçu du run, de graphiques de métriques et de métriques système.

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.

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 : ```sh theme={"system"} 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 : ```sh theme={"system"} 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. ```text theme={"system"} 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` : ```python theme={"system"} 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.

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](/fr/products/wandb/app/console-logs).

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 : ```sh theme={"system"} 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

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` : ```sh theme={"system"} 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](/fr/products/wandb/app/keyboard-shortcuts) (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](/fr/products/wandb/runs/view-logged-runs) 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](/fr/release-notes/sdk-releases). * [Afficher un run spécifique](/fr/products/wandb/runs/view-logged-runs) dans la W\&B App ou dans LEET. * [Raccourcis clavier](/fr/products/wandb/app/keyboard-shortcuts) de la W\&B App et de LEET. * Référence de la commande [`wandb leet`](/fr/products/wandb/ref/cli/wandb-leet). * [Notes de version du SDK](/fr/release-notes/sdk-releases), y compris les modifications apportées à LEET. ## Related topics - [Raccourcis clavier](/fr/products/wandb/app/keyboard-shortcuts.md)