🎵 Initial commit: MusiaIA - AI Music Generator

✨ Features:
- ALS file generator (creates Ableton Live projects)
- ALS parser (reads and analyzes projects)
- AI clients (GLM4.6 + Minimax M2)
- Multiple music genres (House, Techno, Hip-Hop)
- Complete documentation

🤖 Ready to generate music with AI!

CONFIGURAR_API_KEYS.md

@@ -0,0 +1,161 @@
+# 🔑 CONFIGURAR API KEYS - MusiaIA
+
+## ⚠️ IMPORTANTE: Debes hacer esto manualmente
+
+El archivo `.env` tiene placeholders. Debes **editarlo** y reemplazar los valores.
+
+---
+
+## 📝 PASOS PARA CONFIGURAR
+
+### 1. Abrir .env
+
+```bash
+nano .env
+# o
+vim .env
+# o usa cualquier editor
+```
+
+### 2. Cambiar estas líneas:
+
+**Línea 11 - GLM46_API_KEY:**
+```bash
+# ANTES:
+GLM46_API_KEY=your_glm46_api_key_here
+
+# DESPUÉS (con TU API key real):
+GLM46_API_KEY=abc123tu_api_key_real_aqui
+```
+
+**Línea 22 - ANTHROPIC_AUTH_TOKEN:**
+```bash
+# ANTES:
+ANTHROPIC_AUTH_TOKEN=your_auth_token_here
+
+# DESPUÉS (con TU token real):
+ANTHROPIC_AUTH_TOKEN=eyJ...tu_token_completo_aqui
+```
+
+---
+
+## 🎯 ¿DÓNDE CONSEGUIR LAS KEYS?
+
+### GLM4.6
+1. Ve a: https://open.bigmodel.cn/
+2. Crea cuenta o inicia sesión
+3. Ve a API Keys
+4. Crea nueva API Key
+5. **Copia y pega** en `.env` línea 11
+
+### Minimax M2
+1. Ve a: https://api.minimax.io/
+2. Ve a la sección Anthropic
+3. **Copia el ANTHROPIC_AUTH_TOKEN** (línea 224 del .env tenía uno de ejemplo)
+4. **Pega en `.env` línea 22**
+
+---
+
+## ✅ VERIFICAR QUE ESTÁN BIEN
+
+Después de editar `.env`, debería verse así:
+
+```bash
+# .env
+GLM46_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+GLM46_BASE_URL=https://api.z.ai/api/paas/v4
+GLM46_MODEL=glm-4.6
+
+ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
+ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
+MINIMAX_MODEL=MiniMax-M2
+```
+
+---
+
+## 🧪 PROBAR QUE FUNCIONAN
+
+```bash
+# Test 1: Verificar que .env se lee
+python3 -c "
+from decouple import config
+print('GLM46_KEY:', config('GLM46_API_KEY', default='NO CONFIGURADO')[:20] + '...')
+print('ANTHROPIC_TOKEN:', config('ANTHROPIC_AUTH_TOKEN', default='NO CONFIGURADO')[:20] + '...')
+"
+
+# Test 2: Probar IA (si keys están bien)
+python3 src/backend/ai/example_ai.py
+```
+
+---
+
+## ❌ ERRORES COMUNES
+
+### "API key not configured"
+- **Causa**: No pusiste tu API key real
+- **Solución**: Edita `.env` y cambia los placeholders
+
+### "Invalid API key"
+- **Causa**: API key incorrecta o expirada
+- **Solución**: Ve a la plataforma y genera una nueva
+
+### "ModuleNotFoundError: decouple"
+- **Causa**: No instalaste dependencias
+- **Solución**: `pip install python-decouple`
+
+---
+
+## 🎯 EJEMPLO COMPLETO
+
+```bash
+# 1. Editar .env
+nano .env
+
+# 2. Cambiar líneas 11 y 22
+GLM46_API_KEY=sk-1234567890abcdef...
+ANTHROPIC_AUTH_TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
+
+# 3. Guardar y salir (Ctrl+X, Y, Enter en nano)
+
+# 4. Probar
+python3 src/backend/ai/example_ai.py
+```
+
+---
+
+## 📞 SI NECESITAS AYUDA
+
+### Ver .env actual:
+```bash
+cat .env | grep -E "GLM46_API_KEY|ANTHROPIC_AUTH_TOKEN"
+```
+
+### Verificar formato:
+```bash
+# Debe mostrar algo así (no los placeholders):
+GLM46_API_KEY=sk-...
+ANTHROPIC_AUTH_TOKEN=eyJ...
+```
+
+### Reiniciar:
+Después de editar `.env`, reinicia cualquier terminal o ejecución.
+
+---
+
+## ✅ DESPUÉS DE CONFIGURAR
+
+Una vez que tengas las API keys reales:
+
+```bash
+# Probar generación completa
+python3 src/backend/als/example_usage.py
+
+# Probar IA
+python3 src/backend/ai/example_ai.py
+
+# ¡Y abrir los .als en Ableton Live!
+```
+
+---
+
+**¡Con las API keys configuradas ya puedes generar música con IA!** 🎵🤖