Files
educar/progreso/2024-06-07-motor-imagenes-local.md
2025-11-30 03:11:18 +00:00

21 lines
1.5 KiB
Markdown

# 2024-06-07 · Motor local de imágenes
## Resumen
- Se creó `image_service/` (FastAPI + Diffusers + SD Turbo) que usa la GPU local (RTX 3060 Ti) para generar ilustraciones infantiles.
- El servicio expone `POST /generate` y guarda los PNG en `content/generated/global-words/`. Corre con `uvicorn` en el puerto 8001 usando el entorno `.venv`.
- El backend Nest reemplazó la dependencia de Gemini por `ImageEngineService`, que llama al servicio local y mantiene fallbacks SVG si algo falla.
- Al iniciar el backend se lanza `prefetchAll` para generar todas las palabras. `POST /global-words/prefetch` permite relanzar el proceso manualmente.
- README y `.env.example` actualizados para reflejar el nuevo flujo (variable `IMAGE_SERVICE_URL`).
## Cómo correr todo
1. `source .venv/bin/activate` (opcional si querés revisar el servicio).
2. `nohup .venv/bin/python -m uvicorn image_service.main:app --host 0.0.0.0 --port 8001 >/tmp/image-service.log 2>&1 &`
3. `cd backend && npm run build && nohup node dist/main.js >/tmp/backend.log 2>&1 &`
4. `cd app && npm run dev -- --host 0.0.0.0 --port 4173` (si no estaba corriendo) y abrir `http://localhost:4173`.
## Pendientes / mejoras
- [ ] Ajustar prompts dependiendo del módulo (por ejemplo, palabras de fútbol vs. autos) para variar estilos.
- [ ] Agregar parámetro `seed` por palabra para reproducibilidad.
- [ ] Exponer desde el backend un endpoint para consultar el estado del prefetch (cuántas imágenes faltan).
- [ ] Afinar tamaño/relación de aspecto según categoría.