🎵 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!
This commit is contained in:
renato97
2025-12-01 19:26:24 +00:00
commit 2442673496
35 changed files with 4037 additions and 0 deletions

220
INICIO_RAPIDO.md Normal file
View File

@@ -0,0 +1,220 @@
# 🚀 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*