FlouYo — analizador local de citometría de flujo
================================================

Qué es
------
FlouYo es un clon de FlowJo para PCs de laboratorio. Lee los ficheros .fcs que
exporta tu citómetro, permite compuertas (gates), compensaciones, transformaciones,
estadísticas, control de calidad y un copiloto en lenguaje natural.

Esta copia es la versión de escritorio: TODO el procesamiento ocurre en tu
propio ordenador, así que los ficheros de varios cientos de megabytes se analizan
con toda la potencia de la máquina y ningún dato de tus muestras sale a internet.


Cómo usarlo
-----------
1. Descomprime el ZIP donde quieras (por ejemplo, en el escritorio).

2. Windows:  haz doble clic en        Ejecutar FlouYo.bat
   Linux/Mac: ejecuta                  bash ejecutar_flouyo.sh

   (si tu sistema lo permite puedes ejecutarlo como ./ejecutar_flouyo.sh,
    pero "bash ejecutar_flouyo.sh" funciona siempre)

3. La PRIMERA vez tarda unos minutos: descarga Python si no lo tienes y prepara
   el entorno con las dependencias. A partir de ahí, arranca en segundos.

4. Se abrirá el panel en http://localhost:8010

5. En el panel, botón «Abrir FCS» (o arrastra el fichero sobre la ventana) para
   cargar un .fcs de tu citómetro. El botón «Ruta del servidor» sirve para abrir
   un .fcs que ya esté en el disco del ordenador.

6. Para salir, cierra la ventana negra / la terminal (o pulsa Ctrl+C).

No hace falta contraseña: el panel se abre directamente.


Requisitos
----------
- Windows 10/11, o Linux, o macOS.
- Python 3.10 o superior (el lanzador te avisa si falta y te dice cómo
  instalarlo). En Windows, marca «Add Python to PATH» al instalarlo.
- Conexión a internet solo la primera vez, para descargar las dependencias.


Preguntas frecuentes
--------------------
· «No se encontró Python»
  Instálalo desde python.org/downloads/ o con «sudo apt install python3
  python3-venv» (Linux) / «brew install python3» (macOS).

· El puerto 8010 está ocupado
  Cierra otro programa que lo use, o edita la línea PORT= de este lanzador.

· ¿Guarda mis datos?
  No hay ninguna exportación de ficheros: los resultados se ven en pantalla.
  Lo único que se descarga de esta aplicación es el propio programa.

· ¿Necesita internet para funcionar?
  Solo para la instalación inicial. Después funciona sin conexión.


Estructura
----------
  src/flouyo/   el motor (lectura FCS, gating, compensación, IA, API)
  data/        datos de demostración
  docs/        documentación técnica
  tests/       batería de pruebas
