musica-ia/INICIO_RAPIDO.md

🚀 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:

# .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)

# 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)

# 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)

# 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

# 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

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

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

---

🔧 Comandos Útiles

# 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"

# Usar python3 en su lugar
python3 script.py

Error: "ModuleNotFoundError"

# Instalar dependencias
pip install aiohttp python-decouple

Error: "API key not configured"

# Verificar .env
cat .env | grep API_KEY

# Debe mostrar tu key real (no el placeholder)

Archivo .als no se abre en Ableton

# 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