Este tutorial leva você do zero a uma tarefa de anotação em execução em cerca de cinco minutos. Vamos construir uma pequena tarefa de análise de sentimento, o suficiente para ver como as peças se encaixam.

Passo 1: Instalar o Potato

Instale com o pip:

bash

pip install potato-annotation

Verifique a instalação:

bash

potato --version

Passo 2: Criar sua configuração

Crie um arquivo chamado config.yaml com esta configuração mínima:

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

Passo 3: Criar dados de exemplo

Crie um arquivo data.json com alguns textos de exemplo:

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: Começar a anotar

Inicie o servidor de anotação:

bash

potato start config.yaml

Depois abra http://localhost:8000 no seu navegador e você verá a interface de anotação:

Interface de anotação do Potato

Passo 5: Rotular seus dados

Faça login com qualquer nome de usuário (o Potato cria contas automaticamente)
Leia o texto exibido
Selecione o rótulo de sentimento apropriado
Clique em "Submit" para salvar e avançar para o próximo item

Passo 6: Exportar suas anotações

Suas anotações são salvas automaticamente na pasta annotation_output/. O trabalho de cada anotador é salvo em um arquivo separado.

Para visualizar suas anotações:

bash

cat annotation_output/your_username.jsonl

Para onde ir agora

Essa é uma tarefa de anotação funcional. A partir daqui você pode adicionar atalhos de teclado para rotular mais rápido, enfeitar a interface com instruções, dicas e validação, trazer vários anotadores com gerenciamento de usuários e controle de qualidade, ou experimentar os outros tipos de anotação: spans, caixas de seleção, escalas Likert e o restante. A documentação cobre cada um deles em profundidade, e a vitrine tem configs completas que você pode copiar. Para um passo a passo mais detalhado desta configuração, veja o guia de início rápido.

Com dificuldades? Confira nosso FAQ ou abra uma issue no GitHub.