Iniziare con Potato in 5 Minuti

Pronto per iniziare ad annotare? Questo tutorial rapido ti permetterà di etichettare dati in meno di 5 minuti. Creeremo un semplice task di analisi del sentiment per mostrare le basi.

Passo 1: Installa Potato

Prima di tutto, installa Potato usando pip:

bash

pip install potato-annotation

Verifica l'installazione:

bash

potato --version

Passo 2: Crea la Tua Configurazione

Crea un file chiamato config.yaml con questa configurazione minimale:

yaml

annotation_task_name: "Quick Start Sentiment Analysis"
 
# Il tuo file di dati
data_files:
  - data.json
 
# Interfaccia di annotazione
annotation_schemes:
  - annotation_type: radio
    name: sentiment
    description: "What is the sentiment of this text?"
    labels:
      - Positive
      - Negative
      - Neutral

Passo 3: Crea i Dati di Esempio

Crea un file data.json con alcuni testi di esempio:

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."}

Passo 4: Inizia ad Annotare

Avvia il server di annotazione:

bash

potato start config.yaml

Apri il browser su http://localhost:8000. Vedrai l'interfaccia di annotazione!

Passo 5: Etichetta i Tuoi Dati

Accedi con qualsiasi nome utente (Potato crea gli account automaticamente)
Leggi il testo visualizzato
Seleziona l'etichetta di sentiment appropriata
Clicca "Submit" per salvare e passare all'elemento successivo

Passo 6: Esporta le Tue Annotazioni

Le tue annotazioni vengono salvate automaticamente nella cartella annotation_output/. Il lavoro di ogni annotatore viene salvato in un file separato.

Per visualizzare le tue annotazioni:

bash

cat annotation_output/your_username.jsonl

Qual è il Passo Successivo?

Congratulazioni! Hai completato il tuo primo task di annotazione. Ecco dove andare da qui:

Aggiungi scorciatoie da tastiera: Velocizza l'annotazione con i tasti di scelta rapida
Personalizza l'interfaccia: Aggiungi istruzioni, tooltip e validazione
Configura più annotatori: Configura la gestione degli utenti e il controllo della qualità
Esplora i tipi di annotazione: Prova span, checkbox, scale Likert e altro

Consulta la nostra documentazione per guide dettagliate su ciascuna funzionalità, o sfoglia la showcase per esempi di configurazione completi.

Hai problemi? Controlla le nostre FAQ o apri un issue su GitHub.