Perguntas frequentes

O Potato (Portable Text Annotation Tool) é uma ferramenta de anotação gratuita e de código aberto para criar conjuntos de dados de alta qualidade. Ele permite anotar texto, imagens, áudio e vídeo com um sistema de configuração simples baseado em YAML.

Sim, o Potato é gratuito e de código aberto sob a PolyForm Shield License 1.0.0. Essa licença permite uso gratuito para fins de pesquisa, educação e não comerciais. Ela inclui uma cláusula de não concorrência que impede usar o Potato para criar plataformas de anotação concorrentes. Consulte o arquivo LICENSE no repositório do GitHub para todos os detalhes.

Não é preciso programar. O Potato usa arquivos de configuração em YAML, que são legíveis e fáceis de escrever. Nosso Playground oferece uma interface visual para montar configurações sem escrever código.

Instale via pip: `pip install potato-annotation`. Em seguida, execute `potato start my_project -c config.yaml` para iniciar seu servidor de anotação. Veja nosso guia de início rápido para instruções detalhadas.

O Potato requer Python 3.7 ou superior. Recomendamos usar Python 3.10+ para a melhor experiência.

Execute `pip install --upgrade potato-annotation`. Veja o changelog em /blog para conferir os novos recursos. Suas configurações existentes são compatíveis com versões futuras — não é preciso migração para atualizações de versão menor.

O Potato funciona em todos os navegadores modernos: Chrome, Firefox, Safari e Edge. Recomendamos o Chrome ou o Firefox para a melhor experiência. A interface de anotação é responsiva e funciona em tablets, embora desktops sejam recomendados para tarefas complexas.

Seus dados permanecem na sua máquina. O Potato roda inteiramente em modo local e nunca envia seus dados para servidores externos. Isso o torna ideal para dados sensíveis, como prontuários médicos ou conteúdo proprietário.

Sim. Como o Potato é auto-hospedado e roda localmente, você mantém controle total sobre seus dados. Nenhum dado sai da sua infraestrutura, o que o torna adequado para exigências de conformidade como HIPAA, LGPD e outras.

O Potato suporta vários formatos de entrada, incluindo texto puro, JSON, JSONL, CSV, TSV, imagens (PNG, JPG, GIF, WebP), áudio (MP3, WAV, OGG) e arquivos de vídeo. A saída pode ser exportada para JSON, JSONL, CSV e formatos específicos como CoNLL, spaCy, COCO e datasets do Hugging Face.

O Potato suporta: botões de opção (escolha única), caixas de seleção (multiseleção), escalas Likert, entrada de texto, anotação de span (destaque), caixas delimitadoras, polígonos, comparação par a par, escala best-worst e muito mais. Veja exemplos na nossa Vitrine.

Sim. Uma única tarefa de anotação pode incluir qualquer combinação de esquemas de anotação. Por exemplo, os anotadores podem destacar entidades (anotação de span), classificar o sentimento (botões de opção) e deixar comentários (entrada de texto), tudo no mesmo item.

Sim. O Potato suporta classificação de imagens com rótulos de opção/seleção, anotação de caixas delimitadoras para detecção de objetos e anotação de polígonos para tarefas de segmentação.

Sim. O Potato pode exibir formas de onda de áudio e players de vídeo ao lado dos controles de anotação. Isso é útil para revisão de transcrição, diarização de locutores, detecção de emoção e tarefas semelhantes.

Adicione um esquema de anotação de span na sua configuração, com o texto a destacar. Os anotadores podem selecionar trechos de texto e atribuir rótulos. Veja nossos exemplos de NER e anotação de span na Vitrine.

Sim. O Potato suporta CSS personalizado, templates HTML personalizados e configuração de layout via YAML. Você pode adicionar cabeçalhos, rodapés, instruções e estilos personalizados. Veja a documentação de personalização de layout para detalhes.

O Potato suporta vários anotadores de forma nativa. Cada anotador entra com um ID único, e suas anotações são registradas separadamente. Você pode configurar sobreposição para que vários anotadores rotulem os mesmos itens para controle de qualidade.

Sim. O Potato se integra ao Prolific e ao Amazon Mechanical Turk. Os anotadores são redirecionados da plataforma, fazem as tarefas no Potato e retornam com códigos de conclusão.

O Potato registra quais itens foram anotados por vários anotadores. Você pode exportar as anotações e calcular métricas de concordância (Kappa de Cohen, Alpha de Krippendorff etc.) usando bibliotecas padrão de Python.

Sim. Você pode adicionar itens de verificação de atenção, configurar a sobreposição de anotação exigida e usar o painel administrativo para acompanhar o progresso dos anotadores e identificar possíveis problemas.

Problemas comuns: 1) Verifique se o seu config.yaml tem sintaxe YAML válida. 2) Confirme que seu arquivo de dados existe e está formatado corretamente. 3) Verifique se a porta (8000 por padrão) já não está em uso. 4) Veja a saída do terminal para mensagens de erro específicas.

Verifique se: 1) Você clicou no botão Salvar/Enviar. 2) O diretório de saída tem permissão de escrita. 3) Todos os campos obrigatórios estão preenchidos. Confira o console do navegador em busca de erros de JavaScript.

Exclua o arquivo de anotação do anotador no diretório de saída. A atribuição dele será gerada novamente no próximo login.

Entre na nossa comunidade do Discord para ajuda em tempo real, veja as GitHub Issues para problemas conhecidos ou consulte nossa documentação. A comunidade é receptiva e responde rápido!