- SDK Python W&B (
wandb.sdk) : pour journaliser et surveiller les expériences pendant l’entraînement. - API publique de W&B (
wandb.apis.public) : pour interroger et analyser les données d’expérience journalisées. - API W&B Reports and Workspaces (
wandb.wandb-workspaces) : pour créer un rapport qui synthétise vos constats.
S’inscrire et créer une clé API
Pour authentifier votre machine auprès de W&B, vous devez d’abord générer une clé API sur forge.coreweave.com/settings. Copiez la clé API et conservez-la en lieu sûr.Installer et importer les paquets
Installez la bibliothèque W&B ainsi que les autres paquets nécessaires à ce guide pas à pas.Entraîner un modèle
Le code suivant simule un flux de travail de machine learning de base : entraîner un modèle, consigner des métriques et enregistrer le modèle en tant qu’artifact. Utilisez le SDK Python W&B (wandb.sdk) pour interagir avec W&B pendant l’entraînement. Journalisez la perte avec wandb.Run.log(), puis enregistrez le modèle entraîné en tant qu’artifact avec wandb.Artifact, et ajoutez enfin le fichier du modèle avec Artifact.add_file.
- Utilisez
wandb.Run.log()pour consigner des métriques pendant l’entraînement. - Utilisez
wandb.Artifactpour enregistrer des modèles (ou des jeux de données, etc.) en tant qu’artifact dans votre projet W&B.
wandb.Run.use_artifact() pour récupérer l’artifact depuis votre projet et le préparer à sa publication dans le registre de modèles. wandb.Run.use_artifact() remplit deux fonctions essentielles :
- Il récupère l’objet artifact depuis votre projet.
- Il marque l’artifact comme entrée du run, ce qui garantit la reproductibilité et la traçabilité. Pour plus de détails, consultez Créer et afficher une carte de traçabilité.
Afficher les données d’entraînement dans le tableau de bord
Accédez à votre tableau de bord W&B. Sélectionnez l’onglet Projects et recherchezmy-awesome-project (ou le nom de projet que vous avez choisi ci-dessus). Cliquez dessus pour ouvrir le workspace de votre projet.
Vous y trouverez les détails de chacun de vos runs. Dans cette capture d’écran, le code a été exécuté à plusieurs reprises, ce qui a produit plusieurs runs, chacun doté d’un nom généré aléatoirement.

Publier le modèle dans le registre
Pour partager le modèle avec d’autres membres de votre organisation, publiez-le dans une collection à l’aide dewandb.Run.link_artifact(). Le code suivant associe l’artifact à un registre afin de le rendre accessible à votre équipe.
wandb.Run.link_artifact(), l’artifact de modèle figure dans la collection DemoModels de votre registre. Vous pouvez alors consulter des informations détaillées, comme l’historique des versions, la carte de traçabilité et d’autres métadonnées.
Pour en savoir plus sur la liaison d’artifacts à un registre, consultez Lier des artifacts à un registre.
Récupérer un artifact de modèle depuis le registre pour l’inférence
Pour utiliser un modèle à des fins d’inférence, récupérez l’artifact publié depuis le registre à l’aide dewandb.Run.use_artifact(). Cette méthode renvoie un objet artifact sur lequel vous pouvez ensuite appeler wandb.Artifact.download() pour télécharger l’artifact dans un fichier local.
Partager vos résultats dans un rapport
L’API W&B Report and Workspace est en préversion publique.