ableton-mcp-ai/KIMI_K2_START_HERE.md

Kimi K2 Start Here

Si eres Kimi K2, no empieces a editar codigo hasta leer este archivo completo.

Este proyecto tiene codigo activo, codigo legacy y docs viejas. Si eliges el archivo equivocado, vas a perder tiempo o romper Ableton.

Orden obligatorio de lectura

Lee en este orden:

1. C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\KIMI_K2_START_HERE.md
2. C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\CLAUDE.md
3. C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\KIMI_K2_ACTIVE_HANDOFF.md
4. C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\docs\ROADMAP.md
5. solo despues de eso abrir codigo

No uses primero KIMI_K2_CODEBASE_FIXES.md. No uses primero KIMI_K2_NOTE_API_FIX.md. Esos documentos quedan como contexto historico y contienen partes viejas.

Que es este proyecto

Es un sistema para controlar Ableton Live 12 desde MCP.

Tiene tres capas:

• wrapper MCP y configuracion de clientes
• MCP server con tools y logica musical
• Remote Script dentro de Ableton Live

Verdad actual del proyecto

MCP activo

• wrapper: C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\mcp_wrapper.py
• server real: C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\AbletonMCP_AI\AbletonMCP_AI\MCP_Server\server.py

Runtime activo en Ableton

• shim: C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\AbletonMCP_AI\__init__.py
• shim espejo: C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\AbletonMCP_AI\Remote_Script.py
• runtime canonico: C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\abletonmcp_init.py

Importante:

• hoy los shims cargan primero abletonmcp_init.py
• el backup solo queda como fallback
• no asumas que el backup es el runtime principal

Libreria privada del usuario

No esta en el repo, pero el codigo la usa localmente:

C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\libreria\reggaeton

Ejecutable real de Ableton

C:\ProgramData\Ableton\Live 12 Suite\Program\Ableton Live 12 Suite.exe

Que ya esta arreglado

• AbletonMCP_AI aparece como Control Surface.
• el wrapper MCP funciona por stdio.
• server.py ya no tiene tools duplicadas.
• el runtime canonico es el primero en la ruta activa.
• existe fallback de audio en Arrangement.
• existe pack_brain para elegir material mas coherente.
• existe docs/ROADMAP.md con prioridades reales.

Que sigue roto o flojo

• clear_all_tracks devuelve error blando al final de la limpieza
• Z.ai puede responder 429
• atmos_fx y vocal_shot todavia pueden salir flojos
• la automatizacion real dentro de Live sigue incompleta
• el sistema aun no renderiza, escucha y rerrollea automaticamente

Primer sprint que debes hacer

Haz esto en este orden:

1. arreglar clear_all_tracks
2. agregar backoff + retry + cache a Z.ai
3. endurecer atmos_fx y vocal_shot con same-pack estricto
4. extraer groove real desde drum loops dembow
5. dejar smoke test de generacion async

No abras un frente nuevo antes de cerrar el anterior.

Reglas duras

• usa PowerShell, no bash
• usa rutas absolutas de Windows
• compila antes de probar runtime
• valida con logs y socket, no con intuicion
• no declares exito sin verificar get_session_info
• no edites el backup salvo que estes reparando el fallback
• no crees otro server o wrapper
• no uses docs viejas que contradigan el runtime actual

Comandos minimos antes de tocar codigo

Compilar:

python -m py_compile "C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\mcp_wrapper.py"
python -m py_compile "C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\abletonmcp_init.py"
python -m py_compile "C:\ProgramData\Ableton\Live 12 Suite\Resources\MIDI Remote Scripts\AbletonMCP_AI\AbletonMCP_AI\MCP_Server\server.py"

Ver si Live escucha:

netstat -an | findstr 9877

Ver log de Ableton:

Get-Content "C:\Users\ren\AppData\Roaming\Ableton\Live 12.0.15\Preferences\Log.txt" -Tail 120

Si estas confundido

No adivines.

Haz esto:

1. confirma el entrypoint activo
2. confirma el runtime cargado
3. confirma si el puerto 9877 esta escuchando
4. confirma si el bug esta en MCP o en Live
5. recien ahi parchea

Repositorio publicado

Repo canonico:

https://gitea.cbcren.online/renato97/ableton-mcp-ai

Roadmap canonico:

docs/ROADMAP.md