TRADUCTOR NLP A COMANDOS DE ROBOT - PAQUETE FINAL
=====================================================

CONTENIDO
---------
- Código fuente actual del proyecto.
- Interfaz Gradio.
- Simulación PyBullet.
- Dataset final/auditoría.
- Los 3 checkpoints fine-tuneados de producción.
- Resultados finales del benchmark.

MODELOS ESPERADOS
-----------------
1. FLAN-T5-small fine-tuneado
2. T5-small fine-tuneado
3. mT5-small fine-tuneado

REQUISITOS
----------
- Windows 10/11
- Python 3.10 recomendado
- Internet solo para instalar dependencias.
  Los checkpoints fine-tuneados se incluyen para inferencia local.

INSTALACIÓN EN OTRA COMPUTADORA
-------------------------------
1. Descomprimir el ZIP.
2. Abrir CMD en la carpeta descomprimida.
3. Ejecutar:

   python -m venv .venv
   .venv\Scripts\activate
   python -m pip install --upgrade pip
   pip install -r requirements.txt

EJECUTAR GRADIO
---------------
   .venv\Scripts\activate
   python -m src.app_gradio

Abrir en el navegador:
   http://127.0.0.1:7860

PRUEBA RECOMENDADA
------------------
Escribir:
   Coloca el cubo verde sobre el cuadrado azul

Luego:
- Seleccionar FLAN-T5-small, T5-small o mT5-small.
- Pulsar "Traducir y validar".
- Pulsar "Abrir PyBullet 3D (ventana)".
- Verificar en física cuando corresponda.

IMPORTANTE SOBRE LA SIMULACIÓN
------------------------------
La versión actual usa grounding simbólico:
PyBullet conoce por software la identidad, color y posición de los objetos.
No existe todavía cámara RGB/RGB-D ni percepción visual autónoma.

NO SE INCLUYEN
--------------
- __pycache__
- backups de app_gradio/model_adapter/json_repair
- instaladores/patch históricos
- checkpoints FAILED
- modelos correctivos que no ganaron el benchmark
- archivos temporales de debugging
