# 🪟 GUÍA DE INSTALACIÓN PARA WINDOWS

## 📋 Requisitos Previos

### 1. Instalar Python (si no lo tienes)

1. Ve a: https://www.python.org/downloads/
2. Descarga Python 3.8 o superior
3. **MUY IMPORTANTE:** Durante la instalación, marca ✅ "Add Python to PATH"
4. Click en "Install Now"

Verifica la instalación:
```cmd
python --version
```

### 2. Instalar FFmpeg

**Opción A - Manual (recomendado):**

1. Ve a: https://github.com/BtbN/FFmpeg-Builds/releases
2. Descarga: `ffmpeg-master-latest-win64-gpl.zip`
3. Extrae el ZIP a una carpeta (ej: `C:\ffmpeg`)
4. Añade `C:\ffmpeg\bin` al PATH de Windows:
   - Abre "Configuración del Sistema" → "Variables de entorno"
   - Edita la variable "Path"
   - Añade la ruta: `C:\ffmpeg\bin`
   - Click "Aceptar"

**Opción B - Con Chocolatey (si lo tienes instalado):**
```cmd
choco install ffmpeg
```

Verifica la instalación:
```cmd
ffmpeg -version
```

---

## 🚀 Instalación del Proyecto

### Paso 1: Abrir CMD en la carpeta del proyecto

1. Abre la carpeta `backend` en el Explorador de Windows
2. En la barra de direcciones, escribe `cmd` y presiona Enter
3. Se abrirá una ventana de comandos en esa ubicación

### Paso 2: Ejecutar el instalador

```cmd
install.bat
```

Esto hará:
- ✅ Crear entorno virtual de Python
- ✅ Instalar todas las dependencias
- ✅ Preparar todo para funcionar

---

## ▶️ Cómo Usar

### 1. Activar el entorno virtual

**Cada vez que abras una nueva ventana de CMD**, activa el entorno:

```cmd
venv\Scripts\activate
```

Verás que aparece `(venv)` al inicio de la línea.

### 2. Iniciar el servidor

```cmd
python server.py
```

Deberías ver:
```
🚀 Servidor iniciado en http://localhost:5000
```

### 3. Abrir la interfaz web

- Abre el archivo `tiktok-processor-full.html` con tu navegador
- O ve a: http://localhost:5000 (si configuras rutas estáticas)

---

## 🛠️ Instalación Manual (si install.bat falla)

### Paso a paso:

1. **Crear entorno virtual:**
```cmd
python -m venv venv
```

2. **Activar entorno virtual:**
```cmd
venv\Scripts\activate
```

3. **Actualizar pip:**
```cmd
python -m pip install --upgrade pip
```

4. **Instalar dependencias:**
```cmd
pip install -r requirements.txt
```

5. **Listo, ahora inicia el servidor:**
```cmd
python server.py
```

---

## 🐛 Solución de Problemas en Windows

### Error: "python no se reconoce como comando"

**Solución:** Python no está en el PATH.

1. Reinstala Python marcando "Add Python to PATH"
2. O añádelo manualmente:
   - Busca donde está instalado Python (ej: `C:\Users\TuUsuario\AppData\Local\Programs\Python\Python311`)
   - Añádelo al PATH como hiciste con FFmpeg

### Error: "pip no funciona"

**Solución:**
```cmd
python -m pip install --upgrade pip
```

### Error: "No module named 'flask'"

**Solución:** El entorno virtual no está activado.
```cmd
venv\Scripts\activate
pip install -r requirements.txt
```

### Error: "FFmpeg not found" al procesar videos

**Solución:** 
1. Verifica que FFmpeg está instalado: `ffmpeg -version`
2. Si no funciona, reinicia el CMD después de añadirlo al PATH
3. O reinicia Windows para que los cambios en PATH surtan efecto

### Error: "Access denied" o permisos

**Solución:** Ejecuta el CMD como Administrador:
- Click derecho en CMD → "Ejecutar como administrador"

### El servidor se cierra inmediatamente

**Solución:** Hay un error en el código. Verifica:
```cmd
python server.py
```
Y lee el mensaje de error completo.

---

## 📝 Comandos Útiles para Windows

### Ver archivos en la carpeta:
```cmd
dir
```

### Cambiar de carpeta:
```cmd
cd nombre-carpeta
```

### Volver atrás:
```cmd
cd ..
```

### Limpiar pantalla:
```cmd
cls
```

### Desactivar entorno virtual:
```cmd
deactivate
```

---

## 🎯 Flujo de Trabajo Diario

Cada vez que quieras usar la herramienta:

1. **Abre CMD** en la carpeta `backend`
2. **Activa el entorno:**
   ```cmd
   venv\Scripts\activate
   ```
3. **Inicia el servidor:**
   ```cmd
   python server.py
   ```
4. **Abre** `tiktok-processor-full.html` en tu navegador
5. **¡Procesa videos!** 🎬

Para detener el servidor: `Ctrl + C`

---

## 🔐 Configurar Variables de Entorno (Opcional)

Si no quieres poner las API keys cada vez en la interfaz:

1. Copia `.env.example` a `.env`
2. Edita `.env` con Notepad:
   ```
   OPENAI_API_KEY=tu-key-aqui
   ELEVENLABS_API_KEY=tu-key-aqui
   ELEVENLABS_VOICE_ID=tu-voice-id-aqui
   ```
3. Guarda el archivo

---

## 📦 Crear un Acceso Directo (Opcional)

Para no tener que abrir CMD cada vez:

1. Crea un archivo `iniciar-servidor.bat`:
   ```batch
   @echo off
   cd /d "%~dp0"
   call venv\Scripts\activate
   python server.py
   pause
   ```
2. Guárdalo en la carpeta `backend`
3. Haz doble click para iniciar el servidor

---

## ✨ ¡Listo!

Ahora tu herramienta funciona en Windows.

**Siguiente paso:** Procesa tu primer video siguiendo las instrucciones en pantalla.

---

## 🆘 ¿Más Problemas?

Si algo no funciona:
1. Asegúrate de que Python y FFmpeg están en el PATH
2. Reinicia el CMD después de instalar Python/FFmpeg
3. Ejecuta como Administrador si hay problemas de permisos
4. Verifica que tienes conexión a internet (para instalar dependencias)

**¿Sigue sin funcionar?** Copia el error completo y búscalo en Google o pregúntame con el mensaje de error exacto.


Si te salen fallos quizás tengas que instalar todas las dependencias una por una 
pip install flask
pip install flask-cors
pip install openai
pip install requests
pip install opencv-python
pip install numpy
pip install Pillow
pip install yt-dlp
pip install python-dotenv
