Skip to content
Tutorials2 min read

Comenzando con Potato en 5 Minutos

Una guía rápida para configurar tu primer proyecto de anotación con Potato, desde la instalación hasta tus primeros datos etiquetados.

Potato Team·

Comenzando con Potato en 5 Minutos

¿Listo para comenzar a anotar? Este tutorial rápido te tendrá etiquetando datos en menos de 5 minutos. Crearemos una tarea simple de análisis de sentimiento para demostrar los conceptos básicos.

Paso 1: Instalar Potato

Primero, instala Potato usando pip:

bash
pip install potato-annotation

Verifica la instalación:

bash
potato --version

Paso 2: Crear Tu Configuración

Crea un archivo llamado config.yaml con esta configuración 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

Paso 3: Crear Datos de Ejemplo

Crea un archivo data.json con algunos textos de ejemplo:

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

Paso 4: Comenzar a Anotar

Inicia el servidor de anotación:

bash
potato start config.yaml

Abre tu navegador en http://localhost:8000. ¡Verás la interfaz de anotación!

Paso 5: Etiquetar Tus Datos

  1. Inicia sesión con cualquier nombre de usuario (Potato crea cuentas automáticamente)
  2. Lee el texto mostrado
  3. Selecciona la etiqueta de sentimiento apropiada
  4. Haz clic en "Submit" para guardar y pasar al siguiente elemento

Paso 6: Exportar Tus Anotaciones

Tus anotaciones se guardan automáticamente en la carpeta annotation_output/. El trabajo de cada anotador se guarda en un archivo separado.

Para ver tus anotaciones:

bash
cat annotation_output/your_username.jsonl

¿Qué Sigue?

¡Felicidades! Has completado tu primera tarea de anotación. Aquí tienes a dónde ir desde aquí:

  • Agregar atajos de teclado: Acelera la anotación con teclas rápidas
  • Personalizar la interfaz: Agregar instrucciones, tooltips y validación
  • Configurar múltiples anotadores: Configurar gestión de usuarios y control de calidad
  • Explorar tipos de anotación: Probar spans, casillas de verificación, escalas Likert y más

Consulta nuestra documentación para guías detalladas de cada función, o explora el escaparate para ejemplos completos de configuración.


¿Tienes problemas? Consulta nuestras preguntas frecuentes o abre un issue en GitHub.