> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-run-filter-ui-updates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# Démarrage rapide W&B

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <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>
    Source GitHub
  </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>
    Essayer sur Colab
  </a>;

Installez W\&B pour suivre, visualiser et gérer des expériences de machine learning, quelle que soit leur taille.

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

<div id="sign-up-and-create-an-api-key">
  ## Inscrivez-vous et créez une clé API
</div>

Pour authentifier votre machine auprès de W\&B, vous avez besoin d’une clé API.

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

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

    1. Connectez-vous à W\&B, cliquez sur l’icône de votre profil, puis sur **Paramètres utilisateur**.
    2. Cliquez sur **Create new API key**.
    3. Saisissez un nom descriptif pour votre clé API.
    4. Cliquez sur **Create**.
    5. Copiez immédiatement la clé API affichée et stockez-la de manière sécurisée.
  </Tab>

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

    1. Accédez à l’onglet **Service Accounts** dans les paramètres de votre équipe ou de votre organisation.
    2. Recherchez le compte de service dans la liste.
    3. Cliquez sur le menu **d’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 stockez-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 prendre en charge différents environnements ou flux de travail.
  </Tab>
</Tabs>

<Warning>
  La clé API complète n’est affichée qu’une seule fois, au moment de sa création. Une fois la boîte de dialogue fermée, vous ne pourrez plus voir la clé API complète. Seul l’ID de la clé (la première partie de la clé) reste visible dans vos paramètres. Si vous perdez la clé API complète, vous devrez créer une nouvelle clé API.
</Warning>

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

Ce démarrage rapide est également disponible sous la forme d’un notebook Colab :

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

<div id="install-the-wandb-library-and-log-in">
  ## Installez la bibliothèque `wandb` et connectez-vous
</div>

<Tabs>
  <Tab title="Ligne de commande">
    1. Définissez la variable d'[environnement](/fr/models/track/environment-variables/) `WANDB_API_KEY`.

       ```bash theme={null}
       export WANDB_API_KEY=<your_api_key>
       ```

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

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

  <Tab title="Python">
    ```bash theme={null}
    pip install wandb
    ```

    ```python theme={null}
    import wandb

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

  <Tab title="Python notebook">
    ```notebook theme={null}
    !pip install wandb
    import wandb
    wandb.login()
    ```
  </Tab>
</Tabs>

<div id="initialize-a-run-and-track-hyperparameters">
  ## Initialisez un run et suivez les hyperparamètres
</div>

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

```python theme={null}
import wandb

wandb.login()

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

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

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

Voir la section suivante pour un exemple complet qui simule un run d'entraînement et enregistre les métriques de précision et de perte dans W\&B.

<Info>
  Un [run](/fr/models/runs/) est un élément central de W\&B. Vous utilisez les runs pour [suivre les métriques](/fr/models/track/), [créer des journaux](/fr/models/track/log/), suivre les artifacts, et bien plus encore.
</Info>

<div id="create-a-machine-learning-training-experiment">
  ## Créer une expérience d'entraînement en machine learning
</div>

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

```python theme={null}
import wandb
import random

wandb.login()

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

# Dictionnaire avec les 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})
```

Accédez à [wandb.ai/home](https://wandb.ai/home) pour consulter les métriques enregistrées, comme `accuracy` et `loss`, ainsi que leur évolution à chaque étape d'entraînement. L'image suivante montre les valeurs de `loss` et d'`accuracy` suivies pour chaque run. Chaque objet run apparaît dans la colonne **Runs** avec un nom généré.

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-run-filter-ui-updates/MO-pIWrPJAMQUYwo/images/quickstart/quickstart_image.png?fit=max&auto=format&n=MO-pIWrPJAMQUYwo&q=85&s=445277226e735af23965d6a293b6d646" alt="Montre les valeurs de perte et de précision suivies pour chaque run." width="3456" height="2004" data-path="images/quickstart/quickstart_image.png" />
</Frame>

<div id="next-steps">
  ## Prochaines étapes
</div>

Explorez d'autres fonctionnalités de l'écosystème W\&B :

1. Lisez les [tutoriels d'intégration W\&B](/fr/models/integrations), qui combinent W\&B avec des frameworks comme PyTorch, des bibliothèques comme Hugging Face et des services comme SageMaker.
2. Organisez les runs, automatisez les visualisations, résumez les résultats et partagez des mises à jour avec vos collaborateurs à l'aide de [W\&B Reports](/fr/models/reports).
3. Créez des [W\&B Artifacts](/fr/models/artifacts) pour suivre les jeux de données, les modèles, les dépendances et les résultats tout au long de votre pipeline de machine learning.
4. Automatisez la recherche d'hyperparamètres et optimisez les modèles avec [W\&B Sweeps](/fr/models/sweeps).
5. Analysez les runs, visualisez les prédictions du modèle et partagez vos observations sur un [tableau de bord central](/fr/models/tables).
6. Rendez-vous sur [W\&B AI Academy](https://wandb.ai/site/courses/) pour découvrir les LLM, le MLOps et W\&B Models grâce à des cours pratiques.
7. Rendez-vous sur [weave-docs.wandb.ai](/fr/weave) pour découvrir comment suivre, expérimenter, évaluer, déployer et améliorer vos applications basées sur les LLM avec Weave.
