🎵 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:
220
INICIO_RAPIDO.md
Normal file
220
INICIO_RAPIDO.md
Normal 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*
|
||||
Reference in New Issue
Block a user