# 🚀 INICIO RÁPIDO - MusiaIA

## ⚡ En 5 Minutos Estás Generando Música

### 1️⃣ Configurar API Keys (2 min)

Abre el archivo `.env` y reemplaza las líneas 11 y 22:

```bash
# .env - Línea 11
GLM46_API_KEY=TU_API_KEY_DE_GLM46_AQUI

# .env - Línea 22
ANTHROPIC_AUTH_TOKEN=TU_TOKEN_DE_MINIMAX_AQUI
```

**¿Dónde conseguir las keys?**
- GLM4.6: https://open.bigmodel.cn/
- Minimax M2: https://api.minimax.io/

---

### 2️⃣ Probar (30 seg)

```bash
# Test del generador ALS
python3 src/backend/als/example_usage.py

# Deberías ver:
# ✅ AI House Track generated
# ✅ AI Techno Track generated
# ✅ AI Hip-Hop Beat generated
```

---

### 3️⃣ Abrir en Ableton (30 seg)

```bash
# Los archivos están en:
output/als/AI House Track_*/Ableton Live Project/AI House Track Project/AI House Track.als

# ¡Ábrelo directamente en Ableton Live 11+!
```

---

### 4️⃣ Probar IA (1 min)

```bash
# Test completo con IA (requiere API keys)
python3 src/backend/ai/example_ai.py

# Deberías ver:
# 🎤 Testing GLM4.6 Music Analysis
# ✅ Style: house
# ✅ BPM: 124
# ✅ Key: Am
```

---

## 🎯 Generar Tu Primer Track

```python
# Crear archivo: mi_track.py
from src.backend.ai.ai_clients import AIOrchestrator
from src.backend.als.als_generator import ALSGenerator
import asyncio

async def generar():
    # 1. Analizar tu idea con IA
    orchestrator = AIOrchestrator()
    config = await orchestrator.generate_music_project(
        "tu mensaje aquí, ej: 'track energético de house'"
    )

    # 2. Generar archivo ALS
    generator = ALSGenerator()
    als_path = generator.generate_project(config)

    print(f"✅ ¡Track generado!")
    print(f"📁 Archivo: {als_path}")
    print(f"🎵 Ábrelo en Ableton Live")

# Ejecutar
asyncio.run(generar())
```

---

## 🎼 Ejemplos de Mensajes para IA

Prueba estos prompts:

```
✅ "energetic house track at 124 BPM in A minor"
✅ "dark techno with acid bass at 130 BPM"
✅ "chill hip-hop beat with smooth bass"
✅ "uplifting trance with pads and leads"
✅ "aggressive dubstep with heavy bass"
```

---

## 📊 Ver Proyectos Generados

```bash
# Listar proyectos
ls -la output/als/*/Ableton\ Live\ Project/*/Project/*.als

# Ver estructura
find output/als -name "*.als" -type f
```

---

## 🔧 Comandos Útiles

```bash
# Probar todo el sistema
python3 src/backend/als/example_usage.py

# Probar parser
python3 src/backend/als/test_parser.py

# Probar IA (necesitas API keys)
python3 src/backend/ai/example_ai.py

# Ver proyectos generados
ls -lh output/als/*/Ableton\ Live\ Project/*/Project/*.als
```

---

## 📁 Estructura de un Proyecto

```
Mi Track_123456/
└── Ableton Live Project/
    └── Mi Track Project/
        ├── Mi Track.als              ← Main file (¡Ábrelo!)
        ├── Backup/
        └── Samples/
            └── Imported/
```

---

## ❓ Solución de Problemas

### Error: "python: command not found"
```bash
# Usar python3 en su lugar
python3 script.py
```

### Error: "ModuleNotFoundError"
```bash
# Instalar dependencias
pip install aiohttp python-decouple
```

### Error: "API key not configured"
```bash
# Verificar .env
cat .env | grep API_KEY

# Debe mostrar tu key real (no el placeholder)
```

### Archivo .als no se abre en Ableton
```bash
# Verificar que es gzip válido
gunzip -t output/als/*/Ableton\ Live\ Project/*/Project/*.als

# Debe decir: OK (sin errores)
```

---

## 🎵 Géneros Disponibles

| Género   | Comando ejemplo                        | Tracks |
|----------|----------------------------------------|--------|
| House    | "energetic house at 124 BPM"           | Drums, Bass, Lead, FX |
| Techno   | "dark techno at 130 BPM"               | Kick, Hat, Acid Bass |
| Hip-Hop  | "chill hip-hop beat"                   | Drums, Bass, Vox |
| Pop      | "upbeat pop track"                     | Drums, Keys |
| Trance   | "uplifting trance"                     | Kick, Bass, Pads |

---

## 📞 ¿Necesitas Ayuda?

### Documentación completa:
- `README.md` - Guía general
- `docs/arquitectura.md` - Arquitectura
- `docs/generador_als.md` - Detalles técnicos
- `PROYECTO_STATUS.md` - Estado del proyecto

### Ejemplos listos:
- `src/backend/als/example_usage.py` - Generación básica
- `src/backend/ai/example_ai.py` - IA y chat

---

## 🎉 ¡Ya Estás Listo!

En 5 minutos tienes:
- ✅ Sistema ALS funcionando
- ✅ IA configurada
- ✅ Proyectos generados
- ✅ Ableton Live abierto con tu track

**¡A hacer música con IA!** 🎵🤖

---

*Última actualización: 2025-12-01*