Image File

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai.
Por favor, migra a los componentes alternativos recomendados.

Image File es un componente sencillo que permite a los usuarios cargar una imagen desde su equipo y obtener dos tipos de salida: una representación en base64 que puede ser usada por otros componentes de IA, y un enlace para descargar el archivo original.

¿Cómo funciona?

Cuando el usuario selecciona o sube una imagen, el componente verifica que el formato sea uno de los tipos soportados (jpg, jpeg, png, gif, bmp, tiff).
Si el formato es válido, el archivo se lee en modo binario y se convierte a una cadena base64.
Al mismo tiempo, se crea un mensaje con la ruta del archivo para que el usuario pueda descargarlo directamente desde el dashboard.
El proceso se realiza localmente, sin llamadas a servicios externos, lo que garantiza rapidez y privacidad de los datos.

Entradas

Campos de Entrada

• Upload file or select image
  Permite al usuario subir un archivo o seleccionar una imagen desde su sistema. Los tipos de archivo aceptados son: jpg, jpeg, png, gif, bmp, tiff.

• Silent Errors
  Si se activa, los errores (por ejemplo, un formato no soportado) no generarán una excepción; el componente simplemente devolverá None o un mensaje vacío.

Salidas

• Data
  Tipo: Data (método: load_file).
  Contiene un diccionario con la ruta del archivo descargable (file_path) y la imagen codificada en base64 (image).
  Esta salida es útil para alimentar modelos de IA que requieren la imagen como texto.

• Files
  Tipo: Message (método: result_file).
  Proporciona un enlace de descarga directo al archivo original, facilitando la verificación o el uso posterior del archivo cargado.

Ejemplo de Uso

1. Subir la imagen
   Haz clic en el botón “Upload file or select image” y elige una foto en formato JPG o PNG.

2. Configurar errores silenciosos
   Si prefieres que el componente no interrumpa el flujo en caso de un error, marca la casilla “Silent Errors”.

3. Ejecutar el componente
   Haz clic en “Run” o en el botón de ejecución del dashboard.

4. Revisar las salidas

   • En la pestaña Data verás un objeto con la ruta del archivo y la imagen en base64.
   • En la pestaña Files aparecerá un enlace que te permitirá descargar la imagen original.

5. Usar la salida
   Conecta la salida Data a un componente de clasificación de imágenes o a un modelo de generación de texto que necesite la imagen como entrada.

Componentes Relacionados

• ImageProcessor – Realiza transformaciones (corte, redimensionado, normalización) sobre la imagen cargada.
• ImageClassifier – Utiliza la salida Data para predecir la categoría de la imagen.
• ImageMetadataExtractor – Extrae metadatos EXIF de la imagen y los devuelve en formato JSON.

Consejos y Mejores Prácticas

• Usa formatos comunes: JPG, PNG y GIF son los más compatibles y suelen tener tamaños razonables.
• Limita el tamaño del archivo: Imágenes muy grandes pueden ralentizar el procesamiento y consumir memoria innecesariamente.
• Comprueba la salida base64: Si planeas enviar la imagen a un servicio externo, verifica que la cadena base64 no contenga caracteres inesperados.
• Desactiva “Silent Errors” en entornos de producción: Así podrás detectar rápidamente problemas de formato o de ruta.

Consideraciones de Seguridad

• El componente procesa los archivos localmente; no se envían datos a servidores externos.
• La ruta del archivo se devuelve en la salida Files; asegúrate de que no exponga información sensible sobre la estructura de carpetas del usuario.
• Si la imagen contiene metadatos sensibles (por ejemplo, GPS), considera usar un componente de extracción de metadatos para limpiarlos antes de compartir la imagen.