LivePilot

██╗     ██╗██╗   ██╗███████╗██████╗ ██╗██╗      ██████╗ ████████╗
██║     ██║██║   ██║██╔════╝██╔══██╗██║██║     ██╔═══██╗╚══██╔══╝
██║     ██║██║   ██║█████╗  ██████╔╝██║██║     ██║   ██║   ██║
██║     ██║╚██╗ ██╔╝██╔══╝  ██╔═══╝ ██║██║     ██║   ██║   ██║
███████╗██║ ╚████╔╝ ███████╗██║     ██║███████╗╚██████╔╝   ██║
╚══════╝╚═╝  ╚═══╝  ╚══════╝╚═╝     ╚═╝╚══════╝ ╚═════╝    ╚═╝

Haz el cambio. Escucha lo que pasó. Conserva lo que funciona.
LivePilot conecta un cliente de IA con Ableton Live 12. Esboza ideas, edita el set, compara versiones y aprende de las decisiones que conservas.

474 herramientas · 57 dominios · macOS + Windows

[!NOTE] LivePilot funciona con cualquier cliente MCP, incluidos Claude Code, Claude Desktop, Codex, Cursor, VS Code y Windsurf. Los cambios dentro del set de Live usan la pila de deshacer de Ableton. Las descargas, la memoria guardada, los escaneos de biblioteca y los cambios del instalador ocurren fuera del set y no se pueden deshacer desde Ableton.

[!WARNING] LivePilot avanza rápido. Fija una versión para configuraciones repetibles de estudio o presentaciones en vivo, y revisa el registro de cambios antes de actualizar.

Comienza aquí

El asistente de configuración instala el Remote Script de Ableton, crea el entorno de Python, copia el Analyzer de Max for Live y verifica la conexión:

npx livepilot --setup

¿Usas Claude Desktop? Descarga el último livepilot-<version>.mcpb desde Releases y haz doble clic en él.

Consulta Instalación para opciones específicas por cliente y manuales.

Novedades en v1.30.0

LivePilot ahora gasta mucho menos contexto describiéndose a sí mismo y da respuestas más claras sobre lo que realmente sabe.

• Un primer contacto enfocado. Las sesiones normales anuncian 28 puntos de entrada útiles en lugar de enviar los 474 esquemas por adelantado. El resto sigue siendo buscable y directamente invocable.
• Opciones que significan algo. Los parámetros decorativos de Composer, Atlas y enrutamiento desaparecieron; los roles de muestra y los filtros de material ahora cambian el resultado; los eventos abstractos no compatibles fallan con orientación concreta en lugar de desaparecer silenciosamente.
• Evidencia con etiqueta. Los informes de mezcla y evaluación separan el audio medido, las heurísticas derivadas de la configuración y el juicio artístico. Los objetivos de reducción como "menos brillante" ahora puntúan en la dirección correcta.
• Profundidad cuando vale la pena. Las solicitudes creativas rápidas toman un camino rápido. La exploración en tres vías, las lecturas amplias de memoria y los pases completos de crítico se reservan para la ambigüedad real.
• Sesiones más resilientes. El inicio ya no espera servicios opcionales, los fallos de red ambiguos no reproducen ediciones destructivas, y la memoria del proyecto sigue al set de Live en lugar de a las ediciones ordinarias dentro de él.

La versión anterior v1.29.0 introdujo el gusto perceptual aprendido, puertas de confianza honestas, distancia CLAP opcional y localizadores de Arrangement con nombre.

Detalles completos en el CHANGELOG.

Qué hace LivePilot

LivePilot funciona en dos niveles: control exacto cuando sabes lo que quieres y ayuda informada cuando no lo sabes.

Bajo el capó: un atlas de 5,264 dispositivos, 683 kits de batería mapeados, 29 técnicas de procesamiento de muestras, 44 movimientos semánticos, escucha en tiempo real y sin conexión, y 12 sistemas de planificación y evaluación. Las secciones siguientes muestran cómo funciona cada parte.

Dos formas de hablar con LivePilot

Comienza con el lenguaje que se ajuste al momento. Ambas rutas llegan a la misma superficie de herramientas.

Ruta A — Atajo artístico / estético

"Suena como J Dilla."   "Haz que esto se sienta más como Burial."   "Pads estilo BoC."

Usa un productor o género como atajo para ritmo, densidad, espacio, textura y elecciones de dispositivos. LivePilot traduce la referencia en técnicas en lugar de pretender clonar la identidad de alguien.

Ruta B — Intención musical directa

"Adelanta la caja 4 ms, mantén el bombo en la rejilla, añade ±2 ms de variación de timing a los hats y corta 3 dB alrededor de 380 Hz en la caja."

Cuando el detalle importa, nómbralo: notas, milisegundos, dB, frecuencia, profundidad de modulación, forma de envolvente, nivel de envío, curva de automatización, grado de escala o conducción de voces.

Combinando las rutas

La mayoría de las sesiones usan ambas. Comienza amplio, escucha y luego sé específico donde la pista lo necesite.

Arquitectura

┌──────────────────────────────────────────────────────────────────────┐
│                                                                      │
│  KNOWLEDGE               PERCEPTION              MEMORY              │
│  ──────────────          ──────────────          ──────────────       │
│                                                                      │
│  Device Atlas            9-band FFT              recall by mood,     │
│  5264 devices            RMS / peak              genre, texture      │
│  120 enriched             pitch tracking          29 techniques       │
│  683 drum kits           key detection           replay into session │
│                                                                      │
│  Sample Engine           Corpus Intelligence     Taste Graph          │
│  Splice (local SQLite)   EmotionalRecipe         move preferences    │
│  Browser search          GenreChain              device affinities   │
│  Filesystem scan         PhysicalModelRecipe     novelty tolerance   │
│  6 fitness critics       AutomationGesture                           │
│                                                                      │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐               │
│  │  Device      │  │  M4L         │  │  Technique   │               │
│  │  Atlas       │──│  Analyzer    │──│  Memory      │               │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘               │
│         │                 │                  │                        │
│  ┌──────┴───────┐  ┌──────┴───────┐  ┌──────┴───────┐               │
│  │  Sample      │  │  Corpus      │  │  Composer    │               │
│  │  Engine      │  │  Intelligence│  │  Engine      │               │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘               │
│         └─────────────────┼──────────────────┘                       │
│                           ▼                                          │
│                  ┌─────────────────┐                                  │
│                  │   474 MCP Tools  │                                  │
│                  │   57 domains     │                                  │
│                  └────────┬────────┘                                  │
│                           │                                          │
│           Remote Script ──┤── TCP 9878                                │
│           M4L Bridge ─────┤── UDP 9880 / OSC 9881                    │
│           Splice (local) ─┤── SQLite (downloaded samples)             │
│                           │                                          │
│                  ┌────────────────┐                                   │
│                  │  Ableton Live  │                                   │
│                  │      12        │                                   │
│                  └────────────────┘                                   │
└──────────────────────────────────────────────────────────────────────┘

Cómo se conectan las piezas

Remote Script (remote_script/LivePilot/) — Un ControlSurface de Python que se ejecuta dentro del proceso de Ableton. Escucha en TCP 9878. Todas las llamadas al Live Object Model se ejecutan en el hilo principal de Ableton a través de schedule_message. Detecta la versión de Ableton al inicio y habilita cuatro niveles de capacidades: Core (12.0+), Enhanced Arrangement (12.1.10+), Full Intelligence (12.3+), Collaborative (12.4+).

Servidor MCP (mcp_server/) — Servidor Python FastMCP. Valida entradas, enruta comandos al Remote Script por TCP, gestiona el puente M4L y ejecuta los sistemas de atlas, motor de muestras, compositor, planificación y evaluación. Esto es a lo que se conecta tu cliente de IA.

Puente M4L (m4l_device/) — Efecto de Audio Max for Live opcional en la pista master. Proporciona acceso profundo al LOM a través de LiveAPI de Max que la API de ControlSurface no puede alcanzar. UDP 9880 (M4L al servidor) transporta datos espectrales y respuestas de LiveAPI. OSC 9881 (servidor a M4L) envía comandos. Las 38 herramientas espectrales/analizadoras requieren estrictamente el puente; las herramientas de dispositivos y muestras que llaman al puente también tienen respaldos elegantes, por lo que la funcionalidad principal funciona sin él. Respaldado por 32 comandos de puente para parámetros ocultos, internos de Simpler, marcadores de warp, valores de visualización y escrituras de warp de Simpler / sidechain de Compressor que viven en objetos secundarios a los que Python no puede acceder.

Atlas de Dispositivos (mcp_server/atlas/) — Base de datos JSON indexada en memoria. 5264 dispositivos con URI de navegador (línea base incluida), 120 enriquecidos con perfiles sónicos YAML (estado de ánimo, género, textura, cadenas recomendadas). 7 índices: by_id, by_name, by_uri, by_category, by_tag, by_genre, by_pack. Índice inverso device_techniques_index.json alimenta atlas_techniques_for_device (146 referencias cruzadas en 58 dispositivos). Las elecciones de dispositivos y presets se resuelven contra el atlas antes de cargar, lo que reduce nombres adivinados y callejones sin salida. v1.22.0+: ejecuta scan_full_library después de la instalación para indexar tus packs, User Library y plugins en ~/.livepilot/atlas/device_atlas.json — tu atlas personal anula la línea base y sobrevive a las actualizaciones de npm.

Motor de Muestras (mcp_server/sample_engine/) — Busca en tres fuentes simultáneamente: BrowserSource (biblioteca de Ableton), SpliceSource (catálogo local de Splice vía SQLite), FilesystemSource (directorios de usuario). Cada resultado pasa por una batería de aptitud de 6 críticos (tonalidad, tempo, espectral, género, estado de ánimo, técnico). 29 técnicas de procesamiento (precisión de Surgeon vs. experimentación de Alchemist). Construye planes completos de procesamiento de muestras con recomendaciones de warp, slice y efectos.

Cliente Splice (mcp_server/splice_client/) — Busca el catálogo de Splice a través de dos capas: la base de datos SQLite local (sounds.db, muestras ya descargadas) y la API gRPC en vivo (catálogo completo, incluidas las muestras que aún no has descargado). El cliente gRPC detecta automáticamente el puerto dinámico de Splice vía port.conf, maneja TLS autofirmado y aplica un piso de seguridad de 5 créditos antes de cualquier descarga. Los tiempos de espera por llamada (5–10 s) evitan que un proceso de Splice colgado detenga el bucle de eventos de MCP. Respaldo elegante a solo SQL si grpcio no está instalado. No se necesita clave API — la autenticación proviene de la aplicación de escritorio de Splice en ejecución.

Compositor (mcp_server/composer/) — Pipeline de prompt a plan. Analiza lenguaje natural ("techno minimalista oscuro a 128 bpm con texturas industriales") en un CompositionIntent (género, estado de ánimo, tempo, tonalidad). Planifica capas usando plantillas de roles (kick, bajo, percusión, textura, lead, pad, fx). Compila a un plan paso a paso de llamadas a herramientas que el agente ejecuta. No ejecuta de forma autónoma — devuelve el plan. 4 valores predeterminados de género (house, techno, trap, ambient) — los géneros fuera de este conjunto recurren a un plan de capas neutral.

Corpus (mcp_server/corpus/) — Conocimiento de dispositivos en markdown analizado y convertido en estructuras Python consultables: EmotionalRecipe, GenreChain, PhysicalModelRecipe, AutomationGesture. Alimenta Wonder Mode, los críticos de Sound Design y el Compositor con referencias de producción estructuradas en tiempo de ejecución.

Enrutador de Ejecución (mcp_server/runtime/execution_router.py) — Clasifica cada paso en un plan de múltiples pasos como remote_command (TCP a Ableton), bridge_command (OSC a M4L) o mcp_tool (interno), y luego lo despacha a través del canal correcto.

Cómo toma decisiones LivePilot

Las herramientas hacen la edición. Estos 12 sistemas ayudan a decidir qué probar, qué proteger, qué comparar y qué recordar.

SongBrain — Qué es la canción

Construye un modelo en tiempo real de la sesión: núcleo de identidad (qué define esta pista), elementos sagrados (qué no debe dañarse casualmente), propósitos de sección (qué hace emocionalmente cada parte), arco de energía (hacia dónde va la canción). Detecta deriva de identidad cuando las ediciones alejan la pista de lo que la hacía funcionar.

Taste Graph — Qué te gusta

Aprende tus preferencias de producción entre sesiones. Rastrea qué familias de movimientos conservas vs. deshaces, hacia qué dispositivos gravitas, qué tan experimental quieres que sean las sugerencias (banda de novedad) y qué dimensiones evitas. Cada aceptar/rechazar actualiza el gráfico. Dos productores que usan las mismas herramientas obtienen recomendaciones diferentes.

Movimientos Semánticos — Acciones musicales, no parámetros

44 intenciones de alto nivel en 7 familias (mezcla, arreglo, transición, diseño de sonido, interpretación, creación de dispositivos, muestra) — "añadir contraste," "apretar las frecuencias bajas," "hacer que kick y bajo se bloqueen," "muestrear fantasma vocal," "destruir y luego reconstruir." Cada movimiento se compila en una secuencia concreta de herramientas con nivel de riesgo, dimensiones objetivo y umbrales de protección. Los movimientos controlados por analizador (tighten_low_end, make_kick_bass_lock) marcan sus prelecturas de espectro como opcionales para que el plan continúe incluso cuando el analizador no está disponible. El plan muestra sus compensaciones antes de que algo cambie.

Wonder Mode — Flujo de trabajo para salir de un atasco

Cuando una sesión está atascada — deshacer repetidos, loops sobrepulidos, sin progreso estructural — Wonder Mode se activa:

1. Diagnosticar — clasifica el atasco (¿trampa de loop? ¿falta de contraste? ¿identidad poco clara?)
2. Generar — encuentra movimientos semánticos que aborden el diagnóstico, imponiendo una distinción real
3. Previsualizar — aplica cada variante, captura, deshace. Escucha antes de comprometerte
4. Comprometer o Rechazar — la elección se registra en el gusto y la continuidad de la sesión

Motores Creativos

Cazador de Ganchos

Identifica la idea musical más destacada: clasifica candidatos por recurrencia entre escenas, prominencia del motivo y ubicación en la sección (impulso de sección de recompensa). Rastrea si los ganchos se desarrollan, se descuidan o se socavan, y señala cuando una transición no logra la recompensa esperada. La clasificación del lado rítmico es actualmente heurística (detección de pistas de batería + reutilización de clips); las características rítmicas basadas en onset reales están en la hoja de ruta.

Continuidad de Sesión

Mantiene hilos creativos ("el coro necesita más elevación") y resoluciones de turnos a lo largo de la sesión. Cuando vuelves a un proyecto: "La última vez, mantuviste el barrido de filtro para el puente. El hilo de elevación del coro sigue abierto."

Bucle de Evaluación

Cada motor sigue: medir antes → actuar → medir después → comparar. Si un cambio empeoró las cosas (más enmascaramiento, pérdida de margen dinámico, deriva de identidad), el sistema lo señala antes de que continúes.

Herramientas

LivePilot tiene 474 herramientas en 57 dominios, pero ya no envía todo ese esquema a la IA en cada conexión. El perfil predeterminado producer expone un bucle de producción enfocado de 26 herramientas más search_tools y call_tool; cada otra herramienta permanece buscable y directamente invocable por nombre. Esto mantiene el catálogo inicial por debajo de 40 KB mientras preserva el sistema completo.

Usa LIVEPILOT_TOOL_PROFILE=composition, mixing o sampling para fijar más herramientas de dominio. Establece LIVEPILOT_TOOL_PROFILE=full para clientes heredados o diagnósticos de catálogo. Destacados a continuación — catálogo completo aquí.

Control Principal de Ableton — destacados

Puente M4L — 38 herramientas de análisis [optional], 32 comandos de puente

El Analizador M4L se encuentra en la pista master. UDP 9880 transporta datos espectrales al servidor. OSC 9881 envía comandos de vuelta. El pre-vuelo ensure_analyzer_on_master (v1.20.3) carga el analizador de forma idempotente cuando una decisión dependiente de audio lo necesita.

[!TIP] La mayoría de las herramientas funcionan sin el analizador: agrega 38 herramientas espectrales/analizadoras (frecuencia, sonoridad, percepción, Simpler, warp) y cierra el bucle de retroalimentación.

SPECTRAL ─────── 9-band frequency decomposition (sub_low → air)
                 sub_low (20-60 Hz) split off so kick fundamentals don't hide inside sub
                 true RMS / peak metering
                 Krumhansl-Schmuckler key detection

DEEP LOM ─────── hidden parameters beyond ControlSurface API
                 automation state per parameter
                 recursive device tree (6 levels into nested racks)
                 human-readable display values as shown in Live's UI

SIMPLER ──────── replace / load samples
                 get slice points, crop, reverse
                 warp to N beats, get audio file paths

WARP ─────────── get / add / move / remove markers
                 tempo manipulation at the sample level

Atlas de Dispositivos — 13 herramientas

El atlas es una base de datos indexada en memoria de toda la biblioteca de dispositivos de Ableton.

5264 devices total
  120 enriched with sonic intelligence (mood, genre, texture, chains)
   47 with aesthetic-tagged signature_techniques
  683 drum kits mapped with note assignments
    7 indexes: by_id, by_name, by_uri, by_category, by_tag, by_genre, by_pack
  146 technique cross-references across 58 devices (reverse-index)

atlas_search                   Search devices by name, category, or tag
atlas_device_info              Full enriched profile for a single device
atlas_suggest                  Suggest devices for a musical intent (e.g., "warm pad")
atlas_chain_suggest            Build a device chain from a genre, artist, or purpose
atlas_compare                  Compare two devices side-by-side
atlas_describe_chain           Free-text describe-a-chain ("granular pad like Tim Hecker")
atlas_techniques_for_device    Reverse-lookup: what techniques reference this device?
atlas_pack_info                Inspect a single Ableton pack — devices + enrichment coverage
scan_full_library              Scan what's actually installed on this machine
reload_atlas                   Hot-reload the atlas after adding enrichments
extension_atlas_search         [v1.23.0+] Search user-local atlas overlays
extension_atlas_get            [v1.23.0+] Fetch a single overlay entry by namespace
extension_atlas_list           [v1.23.0+] Enumerate overlay namespaces + entity_type counts

# Pack-Atlas Phase C-F (v1.23.4+) — corpus-driven orchestration
atlas_macro_fingerprint        [v1.23.4+] "More like this" — find similar presets across 3,813 sidecars by macro fingerprint
atlas_transplant               [v1.23.4+] Adapt a demo / preset / workflow to new BPM, scale, or aesthetic — PRESERVE / SCALE / REMAP / REPLACE decisions
atlas_demo_story               [v1.23.4+] Track-by-track narrative + production sequence inference for any of 104 factory demo .als
atlas_extract_chain            [v1.23.4+] Surgically rebuild a demo track's device chain as an executable plan (load_browser_item + insert_device + set_device_parameter)
atlas_pack_aware_compose       [v1.23.4+] Bootstrap a project with pack-coherent track selection from an aesthetic brief; supports `pack_diversity="eclectic"` mode
atlas_cross_pack_chain         [v1.23.4+] Execute any of 15 cross-pack workflow recipes step-by-step with aesthetic overrides (target_scale / target_bpm / transpose_semitones)

v1.23.0 — Extensiones locales de usuario: Coloca archivos YAML en ~/.livepilot/atlas-overlays/<namespace>/ para extender el atlas con bibliotecas de hardware personalizadas, cadenas características o recetas de técnicas — sobrevive a las actualizaciones de npm. Consulta docs/EXTENSION_API.md.

v1.23.4 — Fases C/D/E/F del Atlas de Packs: Seis nuevas herramientas de orquestación impulsadas por corpus convierten los 3,917 sidecars de packs analizados + 104 análisis de .als de demostración en artefactos accionables — encuentra presets similares, trasplanta estéticas entre BPM/escala/género, narra una demostración, extrae la cadena de una pista como plan ejecutable, inicia composiciones coherentes con el pack, ejecuta cualquiera de las 15 recetas de flujo de trabajo entre packs. Toda la ejecución es de prueba por defecto — devuelve planes, no muta automáticamente la sesión.

Corpus de Usuario — 14 herramientas [v1.23.4+]

Por qué existe esto. El atlas de fábrica cubre lo que Ableton incluye. La mayoría de los estudios también tienen plugins de terceros, dispositivos Max for Live, racks personalizados, presets y packs de samples. El constructor de corpus indexa esa biblioteca local para que las recomendaciones puedan usar herramientas que realmente posees.

El constructor de corpus convierte lo que está instalado en tu máquina en contexto de producción buscable:

Phase 1 — DETECT      Walk plugin folders + run `auval -a` for AUv3 / Mac Catalyst
                       coverage. Captures format (VST3/AU/AAX/CLAP/LV2),
                       vendor, version, bundle ID. ~40-200 plugins typical.

Phase 2 — CANONICALIZE Dedupe by vendor+name, prefer VST3 over AU, strip vendor
                       suffix variants ("Valhalla DSP, LLC" = "Valhalladsp" =
                       "Valhalla DSP"). Cluster by vendor for batch research.

Phase 3 — RESEARCH    Discover local manual files (PDFs, READMEs) per plugin.
                       Prepare focused plugin and technique research tasks.

Phase 4 — SYNTHESIZE  Build a per-plugin identity.yaml
                       with sonic_fingerprint / reach_for / avoid / key_techniques /
                       parameter_glossary / comparable_plugins / genre_affinity /
                       producer_anchors. Keep one primary format tag (no
                       dual-indexing across formats).

El resultado vive en ~/.livepilot/atlas-overlays/user/plugins/<plugin_id>/identity.yaml y está disponible para atlas_search, atlas_chain_suggest, atlas_macro_fingerprint y atlas_describe_chain junto al atlas de fábrica. Cada resultado nombra su fuente (factory_atlas o user_overlay:user), para que puedas ver si una recomendación proviene del stock de Ableton o de tu propio equipo.

corpus_setup_wizard            One-shot orchestration — runs the full pipeline
corpus_init                    Initialize ~/.livepilot/corpus/ + manifest.yaml
corpus_status                  Inspect manifest, sources, scan history
corpus_list_scanners           Enumerate registered scanner types
corpus_add_source              Register a new scan source (project / racks / Max / samples)
corpus_remove_source           Remove a scan source from manifest
corpus_scan                    Run scanners on configured sources
corpus_detect_plugins          Phase 1 — VST3 / AU / AUv3 / VST2 / AAX / LV2 detection
corpus_canonicalize_plugins    Phase 2 — dedupe + VST3-preferred + suffix strip
corpus_cluster_plugins         Phase 2.5 — group by vendor for efficient research dispatch
corpus_trim_plugin_identity    Slim a yaml to the overlay-required minimum
corpus_discover_manuals        Phase 3 — locate local PDFs / READMEs per plugin
corpus_research_targets        Phase 3 — prepare research tasks for the agent
corpus_emit_synthesis_briefs   Phase 4 — prepare identity briefs per plugin

Por qué esto importa. Un índice estático se vuelve obsoleto cuando tu biblioteca cambia. Vuelve a escanear después de agregar un plugin o rack y LivePilot puede considerarlo junto a los dispositivos de fábrica de Ableton.

Inicio rápido:

# In your MCP client (Claude Code / Desktop / Cursor):
corpus_setup_wizard                              # one-shot orchestration
# OR fine-grained control:
corpus_detect_plugins use_auval=true             # finds AUv3 / Mac Catalyst plugins
corpus_canonicalize_plugins                      # VST3 preference + vendor dedup
corpus_cluster_plugins                           # vendor-grouped clusters
corpus_research_targets                          # → agent researches the plugins
corpus_emit_synthesis_briefs                     # → agent writes identity profiles

Consulta docs/USER_CORPUS_GUIDE.md para el recorrido completo, docs/PLUGIN_KNOWLEDGE_ENGINE.md para los internals del motor y livepilot/skills/livepilot-corpus-builder/SKILL.md para la habilidad de agente que impulsa el pipeline.

Motor de Samples — 23 herramientas

Busca en Ableton, carpetas locales y Splice juntos, luego clasifica los resultados según el rol musical en lugar de devolver un montón de nombres de archivo.

SOURCES ─────────── BrowserSource  (Ableton's built-in library)
                    SpliceSource   (local Splice catalog via SQLite)
                    FilesystemSource (user-specified directories)
                    Splice LIVE    (gRPC + GraphQL for the full catalog)

CRITICS ─────────── key fitness · tempo fitness · spectral match
                    genre alignment · mood alignment · technical quality

TECHNIQUES ─────── 29 processing recipes:
                    Surgeon (precise, transparent) vs.
                    Alchemist (experimental, transformative)

PLAN-AWARE ─────── Ableton Live plan   100 samples/day (no credit drain)
                    Sounds+/Creator     CREDIT_HARD_FLOOR=5 safety gate
                    Free samples        bypass both gates

Sample analysis & planning
  analyze_sample            Build complete SampleProfile (material, key, BPM, spectral)
  search_samples            Multi-source search with critic scoring
  evaluate_sample_fit       Score a candidate sample against session context
  suggest_sample_technique  Recommend processing technique for a sample
  plan_sample_workflow      Full processing pipeline: warp + slice + effects
  plan_slice_workflow       Slice-specific workflow for breaks / drum loops
  get_sample_opportunities  Surface sample-friendly spots in the session

Splice LIVE (catalog, collections, presets)
  get_splice_credits        Plan + remaining credits + daily quota state
  splice_catalog_hunt       Query the full Splice catalog (gRPC)
  splice_download_sample    Plan-aware download (credit floor + quota check)
  splice_preview_sample     Zero-cost audition via PreviewURL
  splice_describe_sound     Natural-language search via Splice GraphQL
  splice_generate_variation Find catalog samples similar to a given UUID
  splice_list_collections   Enumerate user's Likes / bass / keys folders
  splice_search_in_collection / add_to_collection / remove_from_collection / create_collection
  splice_list_presets       Purchased instrument presets
  splice_preset_info · splice_download_preset
  splice_pack_info          Per-pack metadata
  splice_http_diagnose      Debug the Splice HTTPS bridge

Integración con Splice

LivePilot lee la base de datos SQLite local de Splice para buscar tus samples descargados con metadatos completos. No se necesita clave API — lee el archivo de base de datos directamente.

Qué hace:

• Busca tus samples de Splice descargados con metadatos de tonalidad, BPM, género y etiquetas
• Se integra como tercera fuente junto al navegador de Ableton y el escaneo del sistema de archivos
• Funciona sin suscripción a Splice — cualquier sample descargado previamente es buscable

Cómo funciona: El SpliceSource del Motor de Samples lee ~/Library/Application Support/com.splice.Splice/users/default/*/sounds.db — el catálogo SQLite local de Splice de samples descargados. Solo lectura, sin llamadas de red.

Requisitos: Aplicación de escritorio de Splice en ejecución (el servidor MCP se comunica con ella a través de gRPC en un puerto dinámico anunciado mediante port.conf, con TLS autofirmado). Para búsqueda totalmente sin conexión, los samples descargados previamente siempre son buscables mediante el respaldo SQLite local incluso si la aplicación de Splice no está en ejecución.

Compositor — tres modos (v1.25.0)

Flujo de trabajo de composición de prompt a plan. Los tres modos comparten las mismas verificaciones de seguridad: reconectar el puente, cargar el analizador cuando sea necesario, configurar el monitoreo correctamente en nuevas pistas y volver a la Vista de Arreglo después de la construcción. El trabajo permanece visible como una secuencia de llamadas a herramientas.

"dark minimal techno 128bpm with industrial textures and ghostly vocals"
    │
    ▼
┌─────────────────┐
│  Prompt Parser   │ → CompositionIntent (genre, mood, tempo, key)
└────────┬────────┘
         ▼
┌─────────────────┐
│  Layer Planner   │ → role templates (kick, bass, perc, texture, lead, pad, fx)
└────────┬────────┘
         ▼
┌─────────────────┐
│  Plan Compiler   │ → executable tool sequences
└────────┬────────┘
         ▼
┌─────────────────┐
│ Execution Router │ → dispatches: create tracks, search samples, load devices,
│                  │   program notes, set volumes, build arrangement
└─────────────────┘

modo rápido — compose_fast_apply

Boceto de loop rápido. Escena única en la vista de sesión. Diseñado para esbozar ideas rápidamente.

• Orden de búsqueda: cadenas curadas de .adg del navegador primero, dispositivos del atlas segundo, instrumentos desnudos solo como último recurso
• Reparación de tono por rol de batería incluida (raíz predeterminada de Simpler vs. desplazamiento MIDI 36)
• 4 predeterminados de género: house, techno, trap, ambient (los géneros desconocidos recurren a un plan de capas neutral)
• Invoca con: "Hazme un loop de [género] a [tempo] BPM"

modo completo — compose_full_apply

Pista completa con forma de canción: intro, verso, gancho, breakdown, outro. Usa un flujo de brief creativo LLM de dos fases — el LLM redacta la forma (secciones, lista de pistas, variantes por sección); el framework proporciona el vocabulario (orden de búsqueda de dispositivos, reglas de generación MIDI, convenciones de arreglo).

• Las variantes MIDI por sección evitan tiles repetidos en todo el arreglo
• Clips de arreglo nativos mediante create_native_arrangement_clip (un clip por sección, en loop para llenar la longitud de la sección)
• Limpieza de pistas zombi en postflight (elimina pistas sin clips y sin dispositivo de instrumento)
• Reparación de tono por rol de batería portada del modo rápido
• Anclas de atlas: el conocimiento de dispositivos a nivel de rol se suministra mediante KnowledgePack.atlas_anchors, que consulta el atlas indexado en lugar de coincidencia de nombres de archivo. El campo más antiguo atlas_candidates_per_role es un stub heredado obsoleto, mantenido vacío para compatibilidad hacia atrás.
• Invoca con: "Escribe una pista completa de [género] a [tempo] BPM" o "Construye un arreglo completo"

modo desarrollar — develop_apply

Extiende un loop existente de 8 compases sin perturbar el material semilla.

• Inspecciona la sesión existente (clasifica pistas por nombre y contenido)
• Extrae referencias artísticas y estilísticas del prompt del usuario
• Escribe variantes por pista y nuevas capas de apoyo junto a la semilla
• Invoca con: "Desarrolla este loop" o "Extiende lo que hay aquí en una idea más larga"

Andamiaje KnowledgePack (v1.25.0)

Los tres modos comparten un KnowledgePack que proporciona contexto creativo estructurado en tiempo de ejecución:

• event_lexicon — 42 eventos estructurales en 7 categorías (densidad de batería, armónico, textura, vocal, sensación rítmica, tensión, gesto de fx)
• genre_context — analiza el genre-vocabularies.md de 15 géneros en tiempo de carga
• artist_context — analiza el artist-vocabularies.md de ~25 productores en tiempo de carga
• atlas_anchors — anclas de dispositivos del atlas indexado por rol (reemplazó el stub heredado atlas_candidates_per_role)

Herramientas principales del compositor

• compose — planifica una composición multicapa desde prompt de texto (punto de entrada, independiente del modo)
• compose_fast_apply — ejecuta el modo rápido directamente
• compose_full_apply — ejecuta el modo completo directamente
• develop_apply — ejecuta el modo desarrollar directamente
• augment_with_samples — planifica capas basadas en samples para una sesión existente
• get_composition_plan — vista previa de prueba (ve el plan sin verificaciones de crédito)

Forja de Dispositivos — 3 herramientas

Genera dispositivos de efectos de audio M4L a partir de plantillas gen~ e instálalos en el navegador de Ableton.

forge_device           Generate a device from a gen~ template
forge_list_templates   Browse available gen~ templates
forge_install          Install generated device to browser

Planificación, Evaluación y Aprendizaje — 79 herramientas

Estas herramientas leen la sesión, diagnostican problemas, planifican cambios, comparan resultados y llevan contexto útil a la siguiente decisión.

Ver las 474 herramientas →

Instalación

Claude Desktop: instalación con un clic

Descarga el último livepilot-<version>.mcpb desde la página de Releases y haz doble clic en él. Claude Desktop instala todo automáticamente. Luego:

1. Abre Ableton Live 12
2. Preferencias → Link, Tempo & MIDI → Superficie de control → LivePilot
3. Empieza a chatear

[!TIP] La extensión de escritorio instala automáticamente el Remote Script y el M4L Analyzer en el primer inicio.

Terminal: configuración con un comando

npx livepilot --setup

Ejecuta el asistente de configuración completo: verifica Python, instala el Remote Script, crea el entorno de Python, copia el M4L Analyzer y prueba la conexión con Ableton.

Manual: paso a paso

npx livepilot --install

# MCP server only:
claude mcp add LivePilot -- npx livepilot

# Or the full plugin (MCP server + skills + slash commands):
claude plugin marketplace add github:dreamrec/LivePilot
claude plugin install livepilot@dreamrec-LivePilot

npx livepilot --install-codex-plugin

{
  "mcpServers": {
    "LivePilot": { "command": "npx", "args": ["livepilot"] }
  }
}

npm install -g livepilot
livepilot --install

{
  "mcpServers": {
    "LivePilot": { "command": "livepilot" }
  }
}

{
  "mcpServers": {
    "LivePilot": { "command": "npx", "args": ["livepilot"] }
  }
}

{
  "servers": {
    "LivePilot": { "command": "npx", "args": ["livepilot"] }
  }
}

Verificación

npx livepilot --status

Plugin

Codex App

npx livepilot --install-codex-plugin

Claude Code

claude plugin marketplace add github:dreamrec/LivePilot
claude plugin install livepilot@dreamrec-LivePilot

Producer Agent — maneja trabajos más largos en etapas visibles: lee la sesión, comprueba lo que conservaste, busca en la biblioteca, propone un plan, aplica ediciones y escucha el resultado. Tú decides qué permanece en el set.

Core Skill — mantiene el trabajo disciplinado: buscar antes de cargar, medir antes y después, preservar el deshacer y verificar cada cambio.

CLI

npx livepilot              # Start MCP server (stdio)
npx livepilot --setup      # Full setup wizard
npx livepilot --install    # Install Remote Script
npx livepilot --uninstall  # Remove Remote Script
npx livepilot --install-codex-plugin   # Install bundled Codex plugin
npx livepilot --uninstall-codex-plugin # Remove bundled Codex plugin
npx livepilot --status     # Check Ableton connection
npx livepilot --doctor     # Full diagnostic check
npx livepilot --version    # Show version

Compatibilidad

Niveles de versión:

• Core (12.0+): Todas las herramientas de sesión, mezcla, dispositivos, MIDI, teoría, generativo, memoria
• Enhanced Arrangement (12.1.10+): Clips de arreglo nativos, automatización de arreglo
• Full Intelligence (12.3+): insert_device_native, pipeline completo de inserción de dispositivos
• Collaborative (12.4+): replace_sample_native y rutas de edición de samples más nuevas que omiten el fallback de M4L cuando Live expone una ruta LOM nativa

Desarrollo

git clone https://github.com/dreamrec/LivePilot.git
cd LivePilot
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
# Test runner is not in requirements.txt (runtime-only deps) — install it explicitly:
.venv/bin/pip install pytest pytest-asyncio
.venv/bin/pytest tests/ -v

Consulta CONTRIBUTING.md para detalles de arquitectura, pautas de código y cómo añadir herramientas.

Documentación

Comunidad

• Discusiones — preguntas, ideas, muestra y cuenta
• Informes de errores
• Solicitudes de funciones
• Guía de contribución
• Política de seguridad

Soporte

LivePilot tiene código fuente disponible bajo la Business Source License 1.1. Si se gana un lugar en tus sesiones, puedes apoyar su desarrollo continuo:

Patrocinar en GitHub

El patrocinio financia una cobertura más profunda de Ableton, pruebas multiplataforma y bibliotecas de técnicas mantenidas. Los patrocinadores también reciben versiones anticipadas y soporte directo.

BSL-1.1 — Pilot Studio

Proyectos hermanos: TDPilot (TouchDesigner) · ComfyPilot (ComfyUI)