# Guía para Arreglar Entorno Python en Windows y Probar Benchmark

Ambito de plataforma: los pasos para desactivar alias de App Installer son
Windows-only. En macOS/Linux no existen esos alias; usa `python3`, un entorno
virtual si hace falta y los comandos POSIX de la seccion correspondiente.

Sigue estos pasos en orden para solucionar los problemas de ejecución en tu terminal y poder probar la optimización.

## Paso 1: Arreglar el comando `python` (Alias de App Installer)
Windows a veces bloquea el comando `python` para intentar instalarlo desde la Store.

1. Presiona la tecla **Windows**.
2. Escribe **"Alias de ejecución"** y selecciona la opción **"Administrar alias de ejecución de aplicaciones"**.
3. En la lista, busca estos dos elementos:
   - `Instalador de aplicación (python.exe)`
   - `Instalador de aplicación (python3.exe)`
4. **Desactívalos** (Mueve el interruptor a "Desactivado").

**Prueba:** Cierra tu terminal actual, abre una nueva y escribe `python --version`. Si sale la versión (ej. 3.11.x), ya funciona.

## Paso 2: Instalar Dependencias
Necesitas instalar las librerías para ejecutar el script de prueba.

### Windows PowerShell

1. En la terminal, ve a la carpeta de la API:
   ```powershell
   cd c:\Users\guill\Desktop\gzutil\www\herramientas\pdf_imagen\api
   ```
2. Instala las librerías necesarias:
   ```powershell
   pip install -r requirements.txt
   ```
3. Instala `pdf2image` (solo necesario para la comparativa del benchmark):
   ```powershell
   pip install pdf2image
   ```

### macOS/Linux

Desde la raiz del repo:

```bash
cd www/herramientas/pdf_imagen/api
python3 -m pip install -r requirements.txt
python3 -m pip install pdf2image
```

## Paso 3: Ejecutar el Benchmark
Ahora ya deberías poder correr la prueba de velocidad.

Windows PowerShell:

```powershell
python benchmark.py
```

macOS/Linux:

```bash
python3 benchmark.py
```

### ¿Qué esperar?
- Verás un error en la parte "Método ANTIGUO" si no tienes Poppler instalado en Windows (es normal).
- Lo importante es ver el tiempo del **"Método NUEVO (PyMuPDF)"**.
- Debería tardar menos de **0.1 segundos** por página.

---

## Solución Alternativa (Si Paso 1 falla)
Si después de desactivar los alias `python` sigue sin funcionar, es posible que no tengas Python instalado o no esté en el PATH.

1. Descarga e instala Python desde [python.org](https://www.python.org/downloads/).
2. **MUY IMPORTANTE**: Al instalar, marca la casilla **"Add Python to PATH"** en la primera pantalla del instalador.

En macOS/Linux, si `python3` no existe, instala Python con el gestor habitual
del sistema o desde python.org y vuelve a ejecutar los comandos `python3 -m pip`.