Instala tu herramienta y entrega tu primera práctica, paso a paso

Navegador

La aplicación con la que visitas páginas de Internet, por ejemplo Chrome o Edge. Su barra de dirección está arriba y muestra la dirección de la página. Allí escribirás una dirección, no en el buscador de una página.

Explorador de archivos

La aplicación de Windows para ver Documentos, Descargas y tus archivos. No es el navegador. Para abrirla, mantén la tecla Windows presionada y pulsa E.

Carpeta

Un lugar para reunir archivos, como una carpeta física reúne hojas. Crearemos una llamada AnotaLab dentro de Documentos.

Archivo y extensión

Un archivo es una unidad guardada: una foto, un documento o un lote de datos. En sentimiento-guiado.json, el nombre termina en .json. Esa terminación es la extensión y ayuda a reconocer el tipo de archivo. Cambiarla no convierte el archivo.

PowerShell, terminal y CMD

Una terminal es una ventana donde das instrucciones escritas al computador. PowerShell y CMD son dos terminales diferentes. En este manual usarás solo PowerShell. El color de la ventana no permite saber cuál es. Si ves CMD o Símbolo del sistema, ciérrala y abre PowerShell como explicamos abajo.

Python y Label Studio

Python es el motor que necesita esta instalación. Instalarlo no significa que tengas que aprender programación. Label Studio es la aplicación donde verás textos, imágenes o audios y pondrás sus etiquetas. Los comandos de instalación ya están preparados.

Copiar y pegar: mantén Ctrl presionada y pulsa C para copiar un texto seleccionado; Ctrl y V para pegarlo. Enter es la tecla que confirma una instrucción. Suéltalas después de cada acción.

Una pestaña es una página abierta dentro del navegador. Mantén el manual en una pestaña y AnotaLab en otra para regresar sin perderte.

• Si el computador es de una escuela o empresa, pide al responsable permiso para instalar Python y Label Studio. No intentes saltarte restricciones.
• Ten conexión estable y espacio para programas y archivos. Si Windows avisa que falta espacio, resuelve eso antes de instalar.
• No desactives el antivirus ni el cortafuegos. Si una protección bloquea el programa, anota el aviso y pide ayuda.
• Usaremos únicamente datos de práctica del curso. No importes archivos de clientes, documentos de identidad ni conversaciones privadas.

1. Abre el Explorador de archivos con Windows y E.
2. En su lado izquierdo, busca y abre Documentos. Puede estar dentro de OneDrive: usa la carpeta que tu Windows muestra; no necesitas escribir una ruta larga.
3. Dentro de Documentos, haz clic derecho en un espacio vacío. Elige Nuevo y luego Carpeta. Escribe AnotaLab y pulsa Enter. Si ya existe, ábrela; no la borres.
4. Haz doble clic en AnotaLab. Guarda aquí tus materiales y resultados.
5. Para ver las terminaciones, busca en el Explorador Ver → Mostrar → Extensiones de nombre de archivo. En algunas versiones aparece en Vista como una casilla. Márcala. Ahora podrás distinguir .json, .xml y .zip.

Lo esperado: estás dentro de una carpeta llamada AnotaLab y puedes reconocer la extensión de los archivos. La carpeta todavía puede estar vacía.

Si Documentos está sincronizada con OneDrive, los archivos guardados allí pueden sincronizarse con esa cuenta. Usa solo los datos sintéticos del curso. La referencia de Microsoft sobre extensiones está en las fuentes oficiales.

Utilizaremos Python 3.13 y Label Studio 1.23.2. Así todos registramos la misma versión de la herramienta. No elijas una versión diferente solo porque la página anuncia una más nueva.

1. Abre en el navegador la página oficial de Python 3.13.16. Comprueba que la dirección pertenece a python.org.
2. Baja hasta Files, la lista de archivos. Elige Windows installer (64-bit) si tu equipo tiene un procesador x64. Para comprobarlo, abre Inicio → Configuración → Sistema → Acerca de y mira Tipo de sistema. Si dice ARM o 32 bits, detente y pide ayuda para elegir la variante; esta ruta está explicada para x64.
3. No elijas un archivo cuyo nombre diga embeddable, source, ZIP ni Python Install Manager. Buscamos el instalador normal de Python 3.13, un archivo .exe.
4. Abre el Explorador y entra en Descargas. Busca el instalador que acabas de descargar. Si tu navegador preguntó dónde guardarlo y elegiste otra carpeta, búscalo allí. Haz doble clic para abrirlo.
5. En el instalador, marca Add python.exe to PATH si aparece. Conserva la instalación del lanzador, llamado launcher o py; si es una opción, inclúyelo. Si aparece Use admin privileges when installing py.exe, déjala desmarcada para esta instalación personal.
6. Elige Install Now, instalar ahora. Espera a que termine. Si pide credenciales de administrador que no tienes, no continúes: pide ayuda al responsable del equipo.
7. Cuando el instalador indique que terminó correctamente, ciérralo. No hace falta abrir un editor de Python ni escribir un programa.

Si no ves esas opciones: no aceptes una pantalla diferente a ciegas. Anota el nombre del archivo descargado y la versión que muestra el instalador. La comprobación del paso 2 confirmará si quedó instalado Python 3.13 y su lanzador.

La documentación del instalador oficial para Windows describe la instalación personal y sus opciones. Los requisitos de Label Studio 1.23.2 incluyen Python 3.10 o posterior, menor que 4. Esa compatibilidad declarada no garantiza que todas las dependencias funcionen en cualquier computador.

Para reconocer PowerShell: haz clic en Inicio, escribe PowerShell y abre Windows PowerShell o PowerShell. No elijas Ejecutar como administrador. La ventana puede mostrar algo parecido a PS C:\…>. Eso indica que espera una instrucción; no es una línea que debas copiar.

Para los pasos siguientes, ábrela directamente en tu carpeta:

1. Si abriste la ventana de prueba desde Inicio, ciérrala.
2. Vuelve al Explorador de archivos y abre Documentos → AnotaLab.
3. Haz clic en la barra de dirección del Explorador, arriba, donde aparece la ubicación de la carpeta. No uses el cuadro Buscar.
4. Escribe únicamente powershell en esa barra y pulsa Enter. Se abrirá PowerShell en la carpeta AnotaLab.

Lo esperado: tienes dos ventanas distintas: el Explorador y PowerShell. Conserva PowerShell abierta y pasa al paso 1 para comprobar su ubicación.

1. Comprueba que la barra de dirección muestra localhost:8080.
2. La primera vez, elige la opción de registro, Sign up. Introduce tu correo y una contraseña nueva que tú eliges. Guárdala en un lugar privado.
3. Completa el registro y entra en la herramienta. Si ya creaste esa cuenta, utiliza la opción de acceso, Log in, con tus propios datos.

Esta cuenta se guarda en tu instalación local de Label Studio. No es una cuenta del curso AnotaLab ni una suscripción comercial. No uses la contraseña de tu correo y no la pegues en PowerShell, ejercicios, capturas ni reportes.

Lo esperado: ves la página de proyectos y una opción para crear uno. Si te ofrece contratar un servicio en una página pública, comprueba de nuevo la dirección.

1. Regresa a la pestaña del curso AnotaLab. Abre el capítulo 1 y lee su guía en Estudiar.
2. Abre Herramientas y archivos. Para comenzar, busca el lote guiado de sentimiento.
3. Pulsa Datos JSON. Después pulsa Configuración XML en la misma tarjeta. Has descargado dos archivos distintos.
4. Abre Descargas en el Explorador. Reconoce el archivo terminado en .json y el terminado en .xml. Si elegiste otra ubicación al descargarlos, abre esa carpeta.
5. Selecciona ambos archivos. Copia con Ctrl y C. Abre Documentos → AnotaLab y pega con Ctrl y V. No borres los originales del curso.

Lo esperado: tienes un JSON con tareas y un XML con la configuración del mismo lote. Por ejemplo, un nombre que contiene sentimiento-guiado y una configuración de sentimiento. No mezcles el lote de imágenes con la configuración de audio.

En el capítulo 4 los CSV son tablas para auditar calidad; no se importan con este procedimiento. En el capítulo 8 reunirás proyectos de capítulos anteriores, no un nuevo lote de Label Studio.

1. Regresa a Label Studio. Pulsa Create, crear.
2. Escribe un nombre fácil de reconocer: C01_sentimiento_guiado.
3. Abre Data Import, importar datos. Usa su opción para elegir o subir un archivo.
4. En la ventana de archivos, abre Documentos → AnotaLab y selecciona el JSON original de tareas que descargaste del curso. Pulsa Abrir y confirma la importación si la pantalla lo pide.
5. Revisa que la cantidad de tareas coincide con la que indica la tarjeta del lote. Todavía no has anotado esos datos.

Lo esperado: aparecen tareas importadas. No importa que aún falten las etiquetas: las configurarás en C4. No importes el XML como datos ni una exportación anterior como si fuera un lote nuevo.

El XML contiene instrucciones para mostrar botones y campos. Ya está preparado; no tienes que inventarlo ni aprender programación.

1. En el Explorador, haz clic derecho en el XML que descargaste. Busca Abrir con y elige Bloc de notas. Si se abrió en el navegador, vuelve al Explorador y usa Abrir con.
2. Dentro de Bloc de notas, pulsa Ctrl y A para seleccionar todo el texto. Pulsa Ctrl y C para copiarlo. No lo cambies ni lo guardes con otro contenido.
3. Regresa a Label Studio. En el proyecto que estás creando, entra en Labeling Setup, configuración de la anotación. Busca Code, el editor de la configuración.
4. Haz clic dentro del editor. Selecciona allí el contenido anterior con Ctrl y A y pega el XML con Ctrl y V. No lo pegues en PowerShell, en el nombre del proyecto ni en la barra de dirección.
5. Comprueba la vista previa: para este lote deben aparecer Positivo, Negativo y Neutral. Pulsa Save, guardar.

Si ya guardaste el proyecto sin configurar: ábrelo, entra en Settings y después en Labeling Interface. Usa Code para pegar el XML y guarda. Hazlo antes de empezar a anotar, no sobre un proyecto con resultados que necesites conservar.

Lo esperado: la vista previa y las tareas muestran el texto y las etiquetas del lote. Si aparece un error de configuración, guarda su mensaje y comprueba que los dos archivos corresponden al mismo lote. No borres etiquetas para ocultar el error.

1. En el proyecto, pulsa Label All Tasks, anotar todas las tareas. Trabaja en una sola pestaña de anotación.
2. Lee el texto completo y las reglas del capítulo. Elige una de las tres etiquetas. Escribe la justificación si el lote muestra ese campo.
3. Revisa tu elección y pulsa Submit, enviar la anotación al proyecto local. Seleccionar una etiqueta no basta para dar la tarea por terminada.
4. Si entraste por Label All Tasks, normalmente aparece la siguiente tarea. Si abriste una tarea individual, puedes tener que volver a la lista para elegir la siguiente.
5. Regresa a la lista del proyecto haciendo clic en su nombre. Abre de nuevo la tarea anterior y comprueba que conserva tu elección.

Lo esperado: la tarea tiene una anotación guardada. Submit guarda en Label Studio de tu computador; no la envía al docente ni a AnotaLab. Completa y revisa el resto del lote antes de exportar.

Crea un proyecto separado para cada lote guiado, independiente o nuevo. Descarga su JSON y su XML juntos. Los nombres y las etiquetas deben coincidir exactamente con esa práctica.

• Entidades: selecciona la clase y marca el fragmento literal del texto con el ratón. Comprueba los bordes y la guía del capítulo 2. No corrijas ni inventes el texto fuente.
• Imágenes: comprueba que ves la ilustración. Elige la clase del objeto objetivo y dibuja su caja; revisa los bordes. El lote de este curso pide el objetivo indicado, no todos los objetos que puedas imaginar.
• Audio: escucha antes de escribir. Usa el XML del lote para marcar segmentos, transcribir lo audible y asignar H1/H2 según las voces. Vuelve a escuchar para comprobar los límites. Las convenciones y los límites de estos audios están en el capítulo 5.
• Comparación de IA: lee la solicitud y ambas respuestas. Elige A, B o Empate siguiendo la rúbrica y justifica. No decidas por longitud ni por posición.
• Simulación y portafolio: utiliza solo los lotes o proyectos que indica su agenda. El portafolio reúne texto, imágenes y comparación de IA; un archivo descargado no acredita por sí solo su calidad.

Después de cada tarea usa Submit. Si una imagen o un audio no carga, registra su identificador y el fallo. No anotes un medio que no puedes ver u oír. Las imágenes y audios referenciados por dirección web necesitan Internet incluso cuando Label Studio funciona localmente.

Un ZIP es un paquete que contiene otros archivos. Descargar los datos JSON no es exportar tus anotaciones. Son dos acciones diferentes y sus archivos pueden terminar igual.

1. Comprueba que terminaste y enviaste con Submit las tareas requeridas del lote. Vuelve a revisar los casos difíciles.
2. En la lista del proyecto, pulsa Export, exportar.
3. Elige JSON. No elijas JSON_MIN, CSV ni otro formato para esta entrega. Confirma con Export.
4. El navegador descargará el archivo o preguntará dónde guardarlo. Abre Descargas en el Explorador si no elegiste otra carpeta.
5. Reconoce el archivo nuevo por su fecha y su extensión .json. Cópialo a Documentos → AnotaLab. Renómbralo con un nombre claro, por ejemplo C01_sentimiento_guiado_intento01.json. Conserva la extensión .json.
6. Si corriges después, vuelve a exportar y usa intento02 en el nuevo nombre. No sobrescribas la primera entrega si necesitas documentar la corrección.

Lo esperado: tienes un nuevo JSON que salió de Export, no de los botones de materiales del curso. La exportación de la edición libre incluye por defecto tareas anotadas: por eso debes comprobar que completaste todo el lote, no solo que existe un archivo.

Si quieres mirarlo sin modificarlo, utiliza Abrir con → Bloc de notas. Puede parecer texto complicado; no necesitas editarlo ni contar llaves. AnotaLab comprobará su estructura al incorporarlo. Un archivo vacío o sin anotaciones no es una entrega completa.

1. Regresa a la pestaña del curso. Abre el capítulo correcto y pulsa Practicar.
2. Abre el ejercicio que corresponde al lote: guiado, independiente o nuevo. Busca Archivo de herramienta.
3. Pulsa Incorporar exportación JSON. En la ventana de archivos elige tu JSON exportado desde Label Studio, no el JSON original ni el XML. El límite de este apartado es 2 MB por archivo.
4. Espera el mensaje. Si rechaza el archivo, lee el motivo y comprueba capítulo, lote y formato. No cambies datos o identificadores al azar.
5. Si lo acepta, comprueba que aparece el nombre y la cantidad de tareas. Usa Descargar archivo guardado si necesitas recuperar una copia desde ese ejercicio.

Lo esperado: el ejercicio muestra el archivo incorporado y su comprobación local. Eso verifica aspectos de estructura y correspondencia, no aprueba la calidad ni confirma recepción docente.

El archivo y las respuestas se guardan en este navegador y este computador. No están sincronizados con tu teléfono ni con una cuenta docente. Conserva además tus archivos en la carpeta y descarga un respaldo del curso.

1. En el capítulo, abre Entregar. Revisa la lista de ejercicios, los archivos pendientes y la rúbrica.
2. Pulsa Descargar paquete del capítulo (ZIP). En el capítulo 8 podrás descargar el paquete de todos los capítulos para el portafolio; si faltan evidencias, será un borrador.
3. Localiza el ZIP en Descargas o en la carpeta que elegiste. Ábrelo y comprueba su contenido antes de compartirlo. No incluyas información privada de terceros.
4. Si vas a solicitar revisión, usa Abrir correo para revisión o tu aplicación de correo. Adjunta tú el ZIP con el botón de archivo adjunto de tu correo y verifica que aparece antes de enviarlo.

Abrir el correo no envía el mensaje y no adjunta automáticamente el ZIP. La página no confirma recepción ni aprobación. La revisión de explicaciones y proyectos corresponde a una persona, con la rúbrica. Para el capítulo 4, adjunta también tu hoja propia si solicitas revisión: la página no incorpora ese CSV personal.

1. Termina la tarea actual con Submit y exporta el resultado que quieras conservar.
2. En AnotaLab pulsa Guardar respaldo. Guarda el archivo descargado en tu carpeta. Es un respaldo del curso, no de toda la instalación de Label Studio.
3. Vuelve a PowerShell. Mantén Ctrl presionada y pulsa C para detener Label Studio. Ahora sí debe volver PS …>. Puedes cerrar esa ventana.
4. Para volver otro día, abre Documentos → AnotaLab en el Explorador. Escribe powershell en su barra de dirección y pulsa Enter, como en A4.
5. Ejecuta únicamente el paso 7. Abre http://localhost:8080, entra con tu cuenta local y abre tu proyecto. No necesitas reinstalar Python, repetir los pasos 3 a 6 ni crear otra cuenta.

Copia adicional de Label Studio: después de detenerlo con Ctrl y C, abre AnotaLab en el Explorador y copia la carpeta datos-label-studio a una ubicación privada de respaldo. No la borres ni la renombres mientras trabajas. Copiar solo .venv no respalda tus proyectos: esa carpeta contiene programas.

Si se cerró PowerShell por accidente, Label Studio dejará de responder. Primero intenta abrirlo de nuevo con el paso 7 desde la misma carpeta. No borres datos para hacer que arranque. Si faltan proyectos, comprueba que estás usando esa misma carpeta antes de hacer cualquier cambio.

py no se reconoce o no encuentra Python 3.13.

Reabre PowerShell después de la instalación. Comprueba que elegiste el instalador de 3.13 y su lanzador. Si persiste, registra el mensaje; no sustituyas comandos por otros encontrados en Internet.

No encuentra .venv, python.exe o label-studio.exe.

Comprueba que estás en Documentos → AnotaLab y que los pasos anteriores terminaron. Get-Location permite reconocer la carpeta. No instales en una carpeta distinta para ocultar el fallo.

La descarga falla o parece detenida.

Comprueba tu conexión y mira las últimas líneas. Si hay error, guarda su texto. No cierres una instalación que sigue descargando ni desactives protecciones del equipo.

localhost no abre.

Comprueba que PowerShell continúa abierta y que el paso 7 sigue funcionando. Si aparece un error de puerto ocupado, anótalo. No cambies configuraciones de red ni abras puertos al azar.

El XML muestra un error.

Comprueba que copiaste su contenido completo en el editor Code y que pertenece al mismo lote que el JSON. No lo pegues en PowerShell ni reemplaces etiquetas por otras.

No veo una imagen o no oigo un audio.

Comprueba conexión y volumen. Guarda el identificador de la tarea. No inventes una anotación para poder avanzar.

AnotaLab rechaza mi archivo.

Comprueba que salió de Export → JSON en Label Studio y que estás en el ejercicio correspondiente. Revisa el motivo mostrado y si terminaste todo el lote. Renombrar un archivo XML como JSON no lo convierte.

Olvidé la contraseña local.

No envíes posibles contraseñas ni crees instalaciones nuevas para recuperar proyectos. Pide apoyo con el procedimiento oficial de recuperación y conserva la carpeta de datos.

• El apartado y paso exacto: por ejemplo, B, paso 5.
• Qué hiciste y qué esperabas ver.
• El mensaje de error completo o sus últimas líneas visibles.
• La versión de Windows y el resultado del paso 2 y del paso 6, si llegaste a ellos.
• El nombre del lote o el identificador de la tarea, si el fallo ocurre al practicar.

Puedes tomar una captura, pero antes comprueba que no muestra contraseñas, correos ajenos, nombres privados ni documentos personales. Describe el error sin esos datos. No incluyas contraseñas en ninguna petición de ayuda.

AnotaLab ofrece ayuda local para revisar justificaciones, bitácoras e informes. Lee cada señal y corrige lo que corresponda. Puede omitir errores o señalar términos válidos: no garantiza ortografía ni redacción perfectas.

Si incorporas una exportación con justificaciones, consulta las incidencias mostradas. Corrige tus explicaciones en Label Studio y exporta de nuevo, o documenta una excepción válida como un nombre o código. No uses esa ayuda para cambiar el texto fuente, entidades literales ni palabras que realmente se oyen en una transcripción. La fidelidad del dato y la calidad de tu explicación son cosas distintas.