> ## 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.

> Installez W&B et commencez en quelques minutes à suivre, visualiser et gérer vos expériences de machine learning.

# Démarrage rapide avec W&B

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "View source" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
      </>}
  </a>;

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Try in Colab
  </a>;

<div style={{ display: 'flex', gap: '12px', flexWrap: 'wrap' }}>
  <ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/intro/run_quickstart.ipynb" />

  <GitHubLink url="https://github.com/wandb/examples/blob/master/colabs/intro/run_quickstart.ipynb" />
</div>

Installez W\&B pour suivre, visualiser et gérer des expériences de machine learning de toutes tailles.

<Note>
  Vous cherchez des informations sur W\&B Weave ? Voir le [démarrage rapide du SDK Python de Weave](/fr/products/wandb/weave/quickstart) ou le [démarrage rapide du SDK TypeScript de Weave](/fr/products/wandb/weave/reference/generated_typescript_docs/intro-notebook).
</Note>

<h2 id="create-an-account">
  Créer un compte
</h2>

Lors de votre première connexion, un court processus de configuration crée votre compte et vous rattache à une organisation. Les étapes affichées dépendent de la façon dont vous accédez à Forge.

<Steps>
  <Step title="Choisir une méthode de connexion">
    Sélectionnez **Continue with Google**, **Continue with GitHub**, **Continue with Apple** ou **Continue with Microsoft**, ou inscrivez-vous avec une adresse e-mail et un mot de passe.

    Si vous disposez déjà d’identifiants Weights & Biases, vous pouvez les utiliser ici. Sélectionnez **Log in** au lieu de **Sign up**.
  </Step>

  <Step title="Vérifier votre adresse e-mail">
    Un lien de vérification est envoyé à l’adresse e-mail associée à votre compte. Si vous ne le recevez pas, consultez votre dossier de courrier indésirable ou sélectionnez **Resend email**.
  </Step>

  <Step title="Créer votre compte">
    Saisissez votre nom complet, votre organisation ou établissement, ainsi qu’un nom d’utilisateur. Votre nom d’utilisateur sert d’URL à votre profil ; il doit donc être unique. Il ne peut contenir que des lettres, des chiffres, des caractères de soulignement et des traits d’union.

    Pour **How will you use Forge?**, sélectionnez **Professional** pour des projets personnels ou d’entreprise, ou **Academic** pour la recherche ou l’enseignement.

    Pour continuer, acceptez les Conditions d’utilisation et la Politique de confidentialité.
  </Step>

  <Step title="Rejoindre votre équipe">
    Si votre domaine d’adresse e-mail correspond à une organisation dont les équipes vous sont ouvertes, vous pouvez rejoindre l’une d’entre elles.

    Si vous avez reçu une invitation d’équipe ou si vous appartenez déjà à une équipe, cette étape ne s’affiche pas.
  </Step>

  <Step title="Créer votre organisation">
    Nommez votre organisation. Ce nom figure dans son URL, par exemple `forge.coreweave.com/my-organization`.

    Si vous avez rejoint une équipe à l’étape précédente, si vous avez reçu une invitation d’équipe ou si vous appartenez déjà à une équipe, cette étape ne s’affiche pas.
  </Step>

  <Step title="Choisir votre domaine de travail">
    Sélectionnez l’une des options suivantes : **Train and fine-tune models**, **Build and evaluate agents**, **Run inference at scale** ou **I'm exploring**. Votre choix détermine la page qui s’affiche ensuite, mais ne limite pas les produits auxquels vous avez accès.
  </Step>
</Steps>

Une fois le processus de configuration terminé, votre compte est prêt à l’emploi.

<h2 id="create-an-api-key">
  Créer une clé API
</h2>

Pour authentifier votre machine, créez une clé API.

Pour savoir comment créer une clé API, sélectionnez l’onglet **Clé API personnelle** ou **Clé API de compte de service**.

<Tabs>
  <Tab title="Clé API personnelle">
    Pour créer une clé API personnelle associée à votre identifiant utilisateur :

    1. Connectez-vous à Forge, puis cliquez sur l’icône de votre profil utilisateur et sélectionnez **User settings**.
    2. Dans la section **API keys**, sélectionnez **New key**.
    3. Fournissez un nom descriptif pour votre clé API.
    4. Cliquez sur **Create API key**.
    5. Copiez immédiatement la clé API affichée et conservez-la en lieu sûr.
  </Tab>

  <Tab title="Clé API de compte de service">
    Pour créer une clé API appartenant à un compte de service :

    1. Dans les paramètres de votre équipe ou de votre organisation, accédez à l’onglet **Service Accounts**.
    2. Trouvez le compte de service dans la liste.
    3. Cliquez sur le menu **action (<Icon icon="ellipsis" iconType="solid" />)**, puis sur **Create API key**.
    4. Saisissez un nom pour la clé API, puis cliquez sur **Create**.
    5. Copiez immédiatement la clé API affichée et conservez-la en lieu sûr.
    6. Cliquez sur **Done**.

    Vous pouvez créer plusieurs clés API pour un même compte de service afin de répondre aux besoins de différents environnements ou flux de travail.
  </Tab>
</Tabs>

<Warning>
  W\&B n’affiche la clé API complète qu’une seule fois, lors de sa création. Une fois la boîte de dialogue fermée, vous ne pouvez plus consulter la clé API complète. Seul l’ID de la clé (sa première partie) apparaît dans vos paramètres. Si vous perdez la clé API complète, vous devez en créer une nouvelle.
</Warning>

Pour connaître les options de stockage sécurisé, consultez [Stocker les clés API en toute sécurité](/fr/products/wandb/platform/app/settings-page/user-settings#store-and-handle-api-keys-securely).

<h2 id="install-the-wandb-library-and-log-in">
  Installer la bibliothèque `wandb` et se connecter
</h2>

<Tabs>
  <Tab title="Ligne de commande">
    1. Définissez la [variable d’environnement](/fr/products/wandb/track/environment-variables) `WANDB_API_KEY`. Remplacez `YOUR_API_KEY` par la clé API que vous avez créée.

       ```bash theme={"system"}
       export WANDB_API_KEY=YOUR_API_KEY
       ```

    2. Installez la bibliothèque `wandb` et connectez-vous :

       ```shell theme={"system"}
       pip install wandb
       wandb login
       ```
  </Tab>

  <Tab title="Python">
    1. Installez le SDK Python W\&B avec `pip` :

       ```bash theme={"system"}
       pip install wandb
       ```

    2. Importez le SDK Python W\&B et connectez-vous à W\&B depuis votre script Python avec `wandb.login()` :

       ```python theme={"system"}
       import wandb

       wandb.login()
       ```
  </Tab>

  <Tab title="Notebook Python">
    1. Utilisez le caractère d’échappement shell (`!`) pour installer le SDK Python W\&B :

       ```notebook theme={"system"}
       !pip install wandb
       ```

    2. Importez le SDK Python W\&B et connectez-vous à W\&B depuis votre notebook avec `wandb.login()` :

       ```notebook theme={"system"}
       import wandb
       wandb.login()
       ```
  </Tab>
</Tabs>

<h2 id="initialize-a-run-and-track-hyperparameters">
  Initialiser un run et suivre les hyperparamètres
</h2>

Dans votre script Python ou votre notebook, initialisez un objet run W\&B avec [`wandb.init()`](/fr/products/wandb/ref/python/experiments/run). Passez un dictionnaire au paramètre `config`
pour définir les noms et les valeurs des hyperparamètres. Dans le bloc `with`, vous pouvez journaliser des métriques et d’autres informations dans W\&B.

```python theme={"system"}
import wandb

wandb.login()

# Projet dans lequel le run est enregistré
project = "my-awesome-project"

# Dictionnaire des hyperparamètres
config = {
    'epochs' : 10,
    'lr' : 0.01
}

with wandb.init(project=project, config=config) as run:
    # Placez votre code d’entraînement ici
    # Journalisez les valeurs dans W&B avec run.log()
    run.log({"accuracy": 0.9, "loss": 0.1})
```

Pour un exemple complet qui simule un run d’entraînement et journalise les métriques de précision et de perte dans W\&B, consultez [Créer une expérience d’entraînement de machine learning](#create-a-machine-learning-training-experiment).

<Info>
  Un [run](/fr/products/wandb/runs) est un élément central de W\&B. Les runs vous permettent de [suivre des métriques](/fr/products/wandb/track), de [créer des journaux](/fr/products/wandb/track/log) et de suivre des artifacts.
</Info>

<h2 id="create-a-machine-learning-training-experiment">
  Créer une expérience d’entraînement de machine learning
</h2>

Ce script d’entraînement fictif journalise dans W\&B des métriques simulées de précision et de perte. Copiez-collez le code suivant dans un script Python ou une cellule de notebook, puis exécutez-le :

```python theme={"system"}
import wandb
import random

wandb.login()

# Projet dans lequel le run est enregistré
project = "my-awesome-project"

# Dictionnaire des hyperparamètres
config = {
    'epochs' : 10,
    'lr' : 0.01
}

with wandb.init(project=project, config=config) as run:
    offset = random.random() / 5
    print(f"lr: {config['lr']}")

    # Simuler un run d’entraînement
    for epoch in range(2, config['epochs']):
        acc = 1 - 2**-config['epochs'] - random.random() / config['epochs'] - offset
        loss = 2**-config['epochs'] + random.random() / config['epochs'] + offset
        print(f"epoch={config['epochs']}, accuracy={acc}, loss={loss}")
        run.log({"accuracy": acc, "loss": loss})
```

Consultez [votre tableau de bord W\&B](https://forge.coreweave.com/wandb) pour afficher les métriques enregistrées, telles que la précision et la perte, et observer leur évolution à chaque étape d’entraînement. L’image suivante montre la perte et la précision suivies pour chaque run. Chaque objet run apparaît dans la colonne **Runs** avec un nom généré automatiquement.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/quickstart_image.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=bd51b523b4bce2c7009d3877740b7a96" alt="L’onglet Workspace d’un projet dans Forge, avec sept runs répertoriés dans la colonne Runs et leurs graphiques de perte et de précision" width="1152" height="653" data-path="products/wandb/_media/quickstart_image.png" />
</Frame>

<h2 id="next-steps">
  Étapes suivantes
</h2>

Explorez d’autres fonctionnalités de W\&B :

* Découvrez les runs et créez votre premier [run](/fr/products/wandb/runs).
* Suivez vos modèles, jeux de données et autres fichiers avec [W\&B Artifacts](/fr/products/wandb/artifacts).
* Automatisez vos recherches d’hyperparamètres et optimisez vos modèles avec [W\&B Sweeps](/fr/products/wandb/sweeps).
* Partagez des modèles, des prompts et des jeux de données avec [Registry](/fr/products/registry).
* Analysez les runs, visualisez les prédictions des modèles et consultez les artifacts dans le [tableau de bord](/fr/products/wandb/track/workspaces) de votre projet.
* Synthétisez vos constats et tenez vos collaborateurs informés grâce à [W\&B Reports](/fr/products/wandb/reports).
* Tracez et évaluez vos applications LLM avec [W\&B Weave](/fr/products/wandb/weave/quickstart).


## Related topics

- [Démarrage rapide](/fr/model-distillation/quickstart.md)
