2442673496
✨ 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!
221 lines
4.5 KiB
Markdown
221 lines
4.5 KiB
Markdown
# 🚀 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*
|