START_SCRIPT_README.md

🚀 Melodix - Script de Inicio Automático

📁 Archivos Creados

Archivo	Propósito
start_services.bat	Script principal para Windows (CMD)
start_services.ps1	Script alternativo para PowerShell
QUICK_START.md	Documentación rápida

---

⚡ Uso Rápido

Iniciar Todo

Doble clic en start_services.bat

O desde consola:

cd c:\mfmm
start_services.bat

---

🎯 Qué Hace el Script

Paso 1: Verificar Redis ✅

• Comprueba que Redis esté corriendo
• Si no, muestra instrucciones para iniciarlo

Paso 2: Verificar Entorno ✅

• Valida que el entorno virtual exista
• Verifica FFmpeg (opcional)

Paso 3: Mostrar Red ✅

• Obtiene tu IP local automáticamente
• Muestra URLs de acceso

Paso 4: Iniciar API ✅

• Lanza FastAPI en puerto 8000
• Espera a que esté disponible
• Abre ventana "API Melodix"

Paso 5: Iniciar Celery ✅

• Lanza worker de procesamiento
• Usa GPU para acelerar
• Abre ventana "Worker Celery"

Paso 6: Túnel Cloudflare ❓

• Pregunta si deseas iniciarlo
• Opcional (recomendado para acceso remoto)
• Abre ventana "Tunel Cloudflare"

---

🖥️ Ventanas que se Abren

┌─────────────────────────────────────────┐
│  API Melodix                            │
│  - FastAPI en puerto 8000               │
│  - No cerrar mientras uses la app       │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│  Worker Celery (GPU)                    │
│  - Procesamiento de audio con IA        │
│  - Usa tu GPU para acelerar             │
└─────────────────────────────────────────┘

┌─────────────────────────────────────────┐
│  Tunel Cloudflare                       │
│  - Expone tu API a internet             │
│  - Opcional, solo si necesitas acceso   │
│    remoto                               │
└─────────────────────────────────────────┘

---

🔧 Comandos Disponibles

Iniciar Servicios

start_services.bat

Detener Servicios

start_services.bat stop

Ver Ayuda

start_services.bat help

---

📱 URLs Después de Iniciar

El script te mostrará:

IP Local: 192.168.1.10

URLs de acceso:
- Local:    http://localhost:8000
- Red:      http://192.168.1.10:8000
- Swagger:  http://localhost:8000/docs

---

✅ Checklist de Verificación

Después de ejecutar el script:

• Ventana "API Melodix" está abierta
• Ventana "Worker Celery" está abierta
• Ventana "Tunel Cloudflare" (si elegiste sí)
• Puedes acceder a http://localhost:8000/health
• Redis está corriendo (verificó el script)

---

🐛 Problemas Comunes

"Redis NO está corriendo"

Solución:

redis-server

O inicia el servicio de Windows:

net start Redis

---

"Ya hay algo corriendo en el puerto 8000"

Opción A: Detener el otro servicio

start_services.bat stop

Opción B: Matar proceso

netstat -ano | findstr :8000
taskkill /F /PID <NUMERO>

---

"La API no respondió"

1. Revisa la ventana "API Melodix" por errores
2. Verifica logs: logs\api.log
3. Prueba manualmente: http://localhost:8000/health

---

📊 Flujo Completo

1. Ejecutar start_services.bat
   ↓
2. Script verifica Redis
   ↓
3. Script verifica entorno Python
   ↓
4. Script muestra IP local
   ↓
5. Inicia API FastAPI (ventana 1)
   ↓
6. Inicia Worker Celery (ventana 2)
   ↓
7. Pregunta por Cloudflare (ventana 3 opcional)
   ↓
8. ¡LISTO! Sistema operativo

---

🛑 Para Detener

Método Recomendado

start_services.bat stop

Método Manual

Cierra las 3 ventanas de consola

---

💡 Tips Pro

1. Acceso desde Android

1. Ejecuta start_services.bat
2. Anota la IP que muestra (ej: 192.168.1.10)
3. En tu Android, usa: http://192.168.1.10:8000

2. Acceso Remoto (Cloudflare)

1. Ejecuta start_services.bat
2. Responde "Y" cuando pregunte por Cloudflare
3. Espera a que se genere la URL en tunnel_url.txt
4. Usa esa URL desde cualquier lugar del mundo

3. Monitoreo

# Ver logs en tiempo real (PowerShell)
Get-Content logs\melodix.log -Wait -Tail 50

# Ver logs de API
Get-Content logs\api.log -Wait -Tail 50

# Ver logs de Celery
Get-Content logs\celery.log -Wait -Tail 50

4. Inicio Automático con Windows

Crea un acceso directo en la carpeta de Inicio:

1. Win + R → shell:startup
2. Crea acceso directo a start_services.bat
3. Edita el acceso directo → Propiedades
4. En "Ejecutar" selecciona: "Minimizada"

---

📝 Estructura de Archivos

c:\mfmm\
├── start_services.bat      # Script principal
├── start_services.ps1      # Script PowerShell
├── QUICK_START.md          # Guía rápida
├── logs\
│   ├── api.log            # Logs de API
│   ├── celery.log         # Logs de Celery
│   └── melodix.log        # Logs generales
└── tunnel_url.txt         # URL de Cloudflare (se crea al iniciar túnel)

---

🎯 Próximos Pasos

Después de iniciar los servicios:

1. Verifica que la API responde:

   curl http://localhost:8000/health
   

2. Abre Swagger UI:

   http://localhost:8000/docs
   

3. Prueba la app MAUI:

   • Abre Visual Studio
   • Compila y ejecuta Melodix
   • Inicia sesión y prueba

4. Conecta desde Android:

   • Mismo WiFi
   • Usa IP local mostrada por el script

---

¡Todo listo! Tu servidor Melodix está operativo 🎵