Skip to content
Tutorials2 min read

Démarrer avec Potato en 5 minutes

Un guide rapide pour configurer votre premier projet d'annotation avec Potato, de l'installation à vos premières données étiquetées.

Potato Team·

Démarrer avec Potato en 5 minutes

Prêt à commencer à annoter ? Ce tutoriel rapide vous permettra d'étiqueter des données en moins de 5 minutes. Nous allons créer une tâche simple d'analyse de sentiments pour démontrer les bases.

Étape 1 : Installer Potato

Tout d'abord, installez Potato avec pip :

bash
pip install potato-annotation

Vérifiez l'installation :

bash
potato --version

Étape 2 : Créer votre configuration

Créez un fichier appelé config.yaml avec cette configuration minimale :

yaml
annotation_task_name: "Quick Start Sentiment Analysis"
 
# Your data file
data_files:
  - data.json
 
# Annotation interface
annotation_schemes:
  - annotation_type: radio
    name: sentiment
    description: "What is the sentiment of this text?"
    labels:
      - Positive
      - Negative
      - Neutral

Étape 3 : Créer des données d'exemple

Créez un fichier data.json avec quelques textes d'exemple :

json
{"id": "1", "text": "I love this product! It's amazing!"}
{"id": "2", "text": "Terrible experience. Would not recommend."}
{"id": "3", "text": "The weather is partly cloudy today."}
{"id": "4", "text": "Best purchase I've ever made!"}
{"id": "5", "text": "This is the worst service I've encountered."}

Étape 4 : Commencer à annoter

Lancez le serveur d'annotation :

bash
potato start config.yaml

Ouvrez votre navigateur à http://localhost:8000. Vous verrez l'interface d'annotation !

Étape 5 : Étiqueter vos données

  1. Connectez-vous avec n'importe quel nom d'utilisateur (Potato crée automatiquement les comptes)
  2. Lisez le texte affiché
  3. Sélectionnez l'étiquette de sentiment appropriée
  4. Cliquez sur "Submit" pour sauvegarder et passer à l'élément suivant

Étape 6 : Exporter vos annotations

Vos annotations sont automatiquement sauvegardées dans le dossier annotation_output/. Le travail de chaque annotateur est sauvegardé dans un fichier séparé.

Pour visualiser vos annotations :

bash
cat annotation_output/your_username.jsonl

Et ensuite ?

Félicitations ! Vous avez terminé votre première tâche d'annotation. Voici les prochaines étapes :

  • Ajouter des raccourcis clavier : Accélérez l'annotation avec des touches de raccourci
  • Personnaliser l'interface : Ajoutez des instructions, des infobulles et de la validation
  • Configurer plusieurs annotateurs : Configurez la gestion des utilisateurs et le contrôle qualité
  • Explorer les types d'annotation : Essayez les spans, les cases à cocher, les échelles de Likert et plus encore

Consultez notre documentation pour des guides détaillés sur chaque fonctionnalité, ou parcourez la vitrine pour des exemples de configuration complets.


Des problèmes ? Consultez notre FAQ ou ouvrez un ticket sur GitHub.