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

> Intégrez W&B à PaddleOCR pour suivre l'entraînement d'un modèle OCR, journaliser les métriques de reconnaissance et visualiser les prédictions.

# PaddleOCR

[PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR) fournit des outils d’OCR multilingues et pratiques qui aident les utilisateurs à entraîner des modèles et à les déployer en production, avec une implémentation dans PaddlePaddle. PaddleOCR prend en charge une gamme d’algorithmes d’OCR et inclut des solutions industrielles. PaddleOCR inclut une intégration W\&B pour la journalisation des métriques d’entraînement et d’évaluation, ainsi que des points de contrôle du modèle et des métadonnées correspondantes.

Cette page vous montre comment activer l’intégration W\&B dans PaddleOCR afin que vos runs d’entraînement OCR transmettent automatiquement en continu les métriques, les résultats de validation et les métadonnées des points de contrôle vers un tableau de bord W\&B. Utilisez cette intégration pour comparer les expériences, surveiller l’entraînement en temps réel et conserver un historique versionné de vos modèles OCR.

<div id="example-blog-and-colab">
  ## Exemple de blog et de Colab
</div>

Voir le [tutoriel d'entraînement PaddleOCR et W\&B](https://wandb.ai/manan-goel/text_detection/reports/Train-and-Debug-Your-OCR-Models-with-PaddleOCR-and-W-B--VmlldzoyMDUwMDIw) pour découvrir comment entraîner un modèle avec PaddleOCR sur le jeu de données ICDAR2015. Cet exemple inclut également un [Google Colab](https://colab.research.google.com/drive/1id2VTIQ5-M1TElAkzjzobUCdGeJeW-nV?usp=sharing) et le [tableau de bord W\&B](https://wandb.ai/manan-goel/text_detection) correspondant en direct. Une version chinoise de ce blog est également disponible : [W\&B对您的OCR模型进行训练和调试](https://wandb.ai/wandb_fc/chinese/reports/W-B-OCR---VmlldzoyMDk1NzE4).

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

Une clé API permet à votre machine de s’authentifier auprès de W\&B. Vous pouvez générer une clé API à partir de votre profil.

<Note>
  Pour une méthode plus directe, accédez aux [Paramètres utilisateur](https://wandb.ai/settings) et créez une clé API. Copiez immédiatement la clé API et conservez-la dans un endroit sûr, par exemple dans un gestionnaire de mots de passe.
</Note>

1. Cliquez sur l’icône de votre profil dans le coin supérieur droit.
2. Sélectionnez **Paramètres utilisateur**, puis faites défiler la page jusqu’à la section **Clés API**.

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

Pour installer la bibliothèque `wandb` localement et vous connecter :

<Tabs>
  <Tab title="Ligne de commande">
    1. Définissez la [variable d'environnement](/fr/models/track/environment-variables/) `WANDB_API_KEY` en lui attribuant votre clé API. Remplacez les valeurs comprises entre `<>` par les vôtres :

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

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

       ```bash 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">
    ```python theme={null}
    !pip install wandb

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

<div id="add-wandb-to-your-configyml-file">
  ## Ajoutez `wandb` à votre fichier `config.yml`
</div>

PaddleOCR vous demande de fournir les variables de configuration via un fichier YAML. Pour activer la journalisation W\&B, ajoutez l’extrait suivant à la fin du fichier de configuration YAML. Ce paramètre configure PaddleOCR pour journaliser automatiquement toutes les métriques d’entraînement et de validation dans un tableau de bord W\&B, ainsi que les points de contrôle du modèle :

```yaml theme={null}
Global:
    use_wandb: True
```

Vous pouvez également ajouter, dans le fichier YAML, sous l’en-tête `wandb`, tous les arguments supplémentaires facultatifs que vous souhaitez transmettre à [`wandb.init()`](/fr/models/ref/python/functions/init) :

```yaml theme={null}
wandb:
    project: CoolOCR  # (facultatif) nom du projet wandb
    entity: my_team   # (facultatif) si vous utilisez une équipe wandb, vous pouvez indiquer le nom de l'équipe ici
    name: MyOCRModel  # (facultatif) nom du run wandb
```

<div id="pass-the-configyml-file-to-trainpy">
  ## Passez le fichier `config.yml` à `train.py`
</div>

Une fois la journalisation W\&B configurée, lancez l’entraînement en passant le fichier YAML en argument au [script d’entraînement](https://github.com/PaddlePaddle/PaddleOCR/blob/release/2.5/tools/train.py) disponible dans le dépôt PaddleOCR.

```bash theme={null}
python tools/train.py -c config.yml
```

Une fois votre fichier `train.py` exécuté avec W\&B activé, PaddleOCR génère un lien vers votre tableau de bord W\&B, où vous pouvez surveiller les métriques d’entraînement et de validation en temps réel :

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-sa-registry-access/Obd-BEsNttVciY7m/images/integrations/paddleocr_wb_dashboard1.png?fit=max&auto=format&n=Obd-BEsNttVciY7m&q=85&s=455b60614109d177c63e2783d1a3c622" alt="Tableau de bord d'entraînement PaddleOCR" width="2880" height="1600" data-path="images/integrations/paddleocr_wb_dashboard1.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-sa-registry-access/Obd-BEsNttVciY7m/images/integrations/paddleocr_wb_dashboard2.png?fit=max&auto=format&n=Obd-BEsNttVciY7m&q=85&s=3d53de2a3ae3de65451a38b809fcfab9" alt="Tableau de bord de validation PaddleOCR" width="2872" height="1572" data-path="images/integrations/paddleocr_wb_dashboard2.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541-sa-registry-access/Obd-BEsNttVciY7m/images/integrations/paddleocr_wb_dashboard3.png?fit=max&auto=format&n=Obd-BEsNttVciY7m&q=85&s=5108019c1561105c878d81c9d73c4123" alt="Tableau de bord du modèle de détection de texte" width="2880" height="1594" data-path="images/integrations/paddleocr_wb_dashboard3.png" />
</Frame>

<div id="feedback-or-issues">
  ## Retours ou problèmes
</div>

Si vous avez des retours ou rencontrez des problèmes avec l’intégration W\&B, ouvrez une issue sur le [GitHub de PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR) ou envoyez un e-mail à <a href="mailto:support@wandb.com">[support@wandb.com](mailto:support@wandb.com)</a>.
