LivePilot

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

Faça a mudança. Ouça o que aconteceu. Mantenha o que funciona.
O LivePilot conecta um cliente de IA ao Ableton Live 12. Esboce ideias, edite o set, compare versões e aprenda com as escolhas que você mantém.

474 ferramentas · 57 domínios · macOS + Windows

[!NOTE] O LivePilot funciona com qualquer cliente MCP, incluindo Claude Code, Claude Desktop, Codex, Cursor, VS Code e Windsurf. Alterações dentro do set do Live usam o histórico de desfazer do Ableton. Downloads, memória salva, varreduras de biblioteca e alterações do instalador acontecem fora do set e não podem ser desfeitas pelo Ableton.

[!WARNING] O LivePilot está evoluindo rapidamente. Fixe uma versão para configurações repetíveis de estúdio ou performance ao vivo e consulte o changelog antes de atualizar.

Comece Aqui

O assistente de configuração instala o Remote Script do Ableton, cria o ambiente Python, copia o Analyzer do Max for Live e verifica a conexão:

npx livepilot --setup

Usando Claude Desktop? Baixe o livepilot-<version>.mcpb mais recente em Releases e clique duas vezes nele.

Consulte Install para configuração específica por cliente e opções manuais.

Novidades na v1.30.0

O LivePilot agora gasta muito menos contexto descrevendo a si mesmo e dá respostas mais claras sobre o que ele realmente sabe.

• Um primeiro contato focado. Sessões normais anunciam 28 pontos de entrada úteis em vez de enviar todos os 474 esquemas de antemão. O restante permanece pesquisável e diretamente acionável.
• Opções que significam algo. Parâmetros decorativos de Composer, Atlas e roteamento foram removidos; papéis de amostra e filtros de material agora mudam o resultado; eventos abstratos não suportados falham com orientação concreta em vez de desaparecerem silenciosamente.
• Evidência com rótulo. Relatórios de mix e avaliação separam áudio medido, heurísticas derivadas da configuração e julgamento artístico. Metas de redução como "menos brilhante" agora pontuam na direção certa.
• Profundidade quando vale a pena. Solicitações criativas rápidas seguem um caminho rápido. Exploração em três vias, leituras amplas de memória e passagens completas de crítica são reservadas para ambiguidade real.
• Sessões mais resilientes. A inicialização não espera mais por serviços opcionais, falhas de rede ambíguas não repetem edições destrutivas e a memória do projeto segue o set do Live em vez de edições comuns dentro dele.

A versão anterior v1.29.0 introduziu gosto perceptual aprendido, portões de confiança honestos, distância CLAP opcional e localizadores nomeados de Arrangement.

Detalhes completos no CHANGELOG.

O Que o LivePilot Faz

O LivePilot trabalha em dois níveis: controle exato quando você sabe o que quer e ajuda informada quando você não sabe.

Nos bastidores: um atlas de 5.264 dispositivos, 683 kits de bateria mapeados, 29 técnicas de processamento de amostras, 44 movimentos semânticos, escuta em tempo real e offline e 12 sistemas de planejamento e avaliação. As seções abaixo mostram como cada parte funciona.

Duas Maneiras de Falar com o LivePilot

Comece com a linguagem que se encaixa no momento. Ambas as rotas alcançam a mesma superfície de ferramentas.

Rota A — Atalho artístico / estético

"Soar como J Dilla."   "Fazer isso parecer mais com Burial."   "Pads estilo BoC."

Use um produtor ou gênero como atalho para ritmo, densidade, espaço, textura e escolhas de dispositivos. O LivePilot traduz a referência em técnicas em vez de fingir clonar a identidade de alguém.

Rota B — Intenção musical direta

"Adiantar a caixa em 4 ms, manter o bumbo no grid, adicionar variação de timing de ±2 ms aos hats e cortar 3 dB em torno de 380 Hz na caixa."

Quando o detalhe importa, nomeie-o: notas, milissegundos, dB, frequência, profundidade de modulação, formato de envelope, nível de send, curva de automação, grau de escala ou condução de vozes.

Misturando as rotas

A maioria das sessões usa ambas. Comece amplo, ouça e depois seja específico onde a faixa precisar.

Arquitetura

┌──────────────────────────────────────────────────────────────────────┐
│                                                                      │
│  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        │                                   │
│                  └────────────────┘                                   │
└──────────────────────────────────────────────────────────────────────┘

Como as peças se conectam

Remote Script (remote_script/LivePilot/) — Um ControlSurface em Python que roda dentro do processo do Ableton. Escuta na porta TCP 9878. Todas as chamadas do Live Object Model são executadas na thread principal do Ableton via schedule_message. Detecta a versão do Ableton na inicialização e habilita quatro níveis de capacidade: Core (12.0+), Enhanced Arrangement (12.1.10+), Full Intelligence (12.3+), Collaborative (12.4+).

MCP Server (mcp_server/) — Servidor Python FastMCP. Valida entradas, roteia comandos para o Remote Script via TCP, gerencia a ponte M4L e executa os sistemas de atlas, mecanismo de amostras, compositor, planejamento e avaliação. É a isso que seu cliente de IA se conecta.

Ponte M4L (m4l_device/) — Efeito de Áudio Max for Live opcional na faixa master. Fornece acesso profundo ao LOM por meio da LiveAPI do Max, que a API do ControlSurface não alcança. UDP 9880 (M4L para servidor) transporta dados espectrais e respostas da LiveAPI. OSC 9881 (servidor para M4L) envia comandos. As 38 ferramentas espectrais/analisadoras exigem estritamente a ponte; ferramentas de dispositivos e amostras que chamam a ponte também têm fallbacks elegantes, então a funcionalidade principal funciona sem ela. Suportada por 32 comandos de ponte para parâmetros ocultos, internals do Simpler, marcadores de warp, valores de exibição e gravações de warp do Simpler / sidechain do Compressor que vivem em objetos filhos que o Python não alcança.

Device Atlas (mcp_server/atlas/) — Banco de dados JSON indexado em memória. 5.264 dispositivos com URIs de navegador (linha de base incluída), 120 enriquecidos com perfis sônicos YAML (humor, gênero, textura, cadeias recomendadas). 7 índices: by_id, by_name, by_uri, by_category, by_tag, by_genre, by_pack. Índice reverso device_techniques_index.json alimenta atlas_techniques_for_device (146 referências cruzadas em 58 dispositivos). Escolhas de dispositivos e presets são resolvidas contra o atlas antes do carregamento, o que reduz nomes adivinhados e becos sem saída. v1.22.0+: execute scan_full_library após a instalação para indexar seus packs, User Library e plugins em ~/.livepilot/atlas/device_atlas.json — seu atlas pessoal substitui a linha de base e sobrevive a atualizações do npm.

Sample Engine (mcp_server/sample_engine/) — Pesquisa três fontes simultaneamente: BrowserSource (biblioteca do Ableton), SpliceSource (catálogo local do Splice via SQLite), FilesystemSource (diretórios do usuário). Cada resultado passa por uma bateria de 6 críticos de adequação (tom, tempo, espectral, gênero, humor, técnico). 29 técnicas de processamento (precisão de Surgeon vs. experimentação de Alchemist). Constrói planos completos de processamento de amostras com recomendações de warp, slice e efeitos.

Splice Client (mcp_server/splice_client/) — Pesquisa o catálogo do Splice por meio de duas camadas: o banco de dados SQLite local (sounds.db, amostras já baixadas) e a API gRPC ao vivo (catálogo completo, incluindo amostras que você ainda não baixou). O cliente gRPC detecta automaticamente a porta dinâmica do Splice via port.conf, lida com TLS autoassinado e impõe um piso de segurança de 5 créditos antes de qualquer download. Timeouts por chamada (5–10s) impedem que um processo do Splice travado pare o loop de eventos do MCP. Fallback elegante para somente SQL se o grpcio não estiver instalado. Nenhuma chave de API é necessária — a autenticação vem do aplicativo desktop do Splice em execução.

Composer (mcp_server/composer/) — Pipeline de prompt para plano. Analisa linguagem natural ("techno minimalista escuro a 128bpm com texturas industriais") em um CompositionIntent (gênero, humor, tempo, tom). Planeja camadas usando modelos de papel (kick, baixo, percussão, textura, lead, pad, fx). Compila em um plano passo a passo de chamadas de ferramentas que o agente executa. Não executa autonomamente — retorna o plano. 4 padrões de gênero (house, techno, trap, ambient) — gêneros fora desse conjunto caem em um plano de camadas neutro.

Corpus (mcp_server/corpus/) — Documentação de conhecimento de dispositivos analisada e convertida em estruturas Python consultáveis: EmotionalRecipe, GenreChain, PhysicalModelRecipe, AutomationGesture. Alimenta o Wonder Mode, os críticos de Sound Design e o Composer com referências de produção estruturadas em tempo de execução.

Execution Router (mcp_server/runtime/execution_router.py) — Classifica cada etapa de um plano de várias etapas como remote_command (TCP para Ableton), bridge_command (OSC para M4L) ou mcp_tool (interno) e a despacha pelo canal correto.

Como o LivePilot Toma Decisões

As ferramentas fazem a edição. Estes 12 sistemas ajudam a decidir o que tentar, o que proteger, o que comparar e o que lembrar.

SongBrain — O Que a Música É

Constrói um modelo em tempo real da sessão: núcleo de identidade (o que define esta faixa), elementos sagrados (o que não deve ser danificado casualmente), propósitos de seção (o que cada parte está fazendo emocionalmente), arco de energia (para onde a música está indo). Detecta desvio de identidade quando edições afastam a faixa do que a fazia funcionar.

Taste Graph — O Que Você Gosta

Aprende suas preferências de produção entre sessões. Rastreia quais famílias de movimentos você mantém vs. desfaz, para quais dispositivos você gravita, quão experimental você quer que as sugestões sejam (faixa de novidade) e quais dimensões você evita. Cada aceitar/recusar atualiza o grafo. Dois produtores usando as mesmas ferramentas recebem recomendações diferentes.

Semantic Moves — Ações Musicais, Não Parâmetros

44 intenções de alto nível em 7 famílias (mix, arrangement, transition, sound_design, performance, device_creation, sample) — "adicionar contraste," "apertar as frequências graves," "fazer kick e baixo se encaixarem," "samplear fantasma vocal," "destruir e reconstruir." Cada movimento compila em uma sequência concreta de ferramentas com nível de risco, dimensões alvo e limites de proteção. Movimentos controlados por analisador (tighten_low_end, make_kick_bass_lock) marcam suas pré-leituras de espectro como opcionais para que o plano continue mesmo quando o analisador não está disponível. O plano mostra suas compensações antes de qualquer mudança.

Wonder Mode — Fluxo de Trabalho para Sair do Impasse

Quando uma sessão está travada — desfazer repetido, loops superpolidos, sem progresso estrutural — o Wonder Mode ativa:

1. Diagnosticar — classificar o travamento (armadilha de loop? contraste ausente? identidade pouco clara?)
2. Gerar — encontrar movimentos semânticos que abordem o diagnóstico, garantindo distinção real
3. Pré-visualizar — aplicar cada variante, capturar, desfazer. Ouvir antes de se comprometer
4. Comprometer ou Rejeitar — escolha registrada no gosto e na continuidade da sessão

Creative Engines

Hook Hunter

Identifica a ideia musical mais saliente — classifica candidatos por recorrência entre cenas, saliência de motivos e posicionamento de seção (bônus de seção de payoff). Rastreia se hooks são desenvolvidos, negligenciados ou prejudicados, e sinaliza quando uma transição não entrega o payoff esperado. A classificação do lado rítmico é atualmente heurística (detecção de trilha de bateria + reutilização de clipes); características rítmicas reais baseadas em onset estão no roadmap.

Continuidade de Sessão

Mantém fios criativos ("o refrão precisa de mais elevação") e resoluções de turnos ao longo da sessão. Quando você retorna a um projeto: "Da última vez, você manteve o sweep de filtro para a ponte. O fio de elevação do refrão ainda está aberto."

Loop de Avaliação

Cada engine segue: medir antes → agir → medir depois → comparar. Se uma mudança piorou as coisas (mais mascaramento, headroom perdido, deriva de identidade), o sistema sinaliza antes de você seguir em frente.

Ferramentas

O LivePilot tem 474 ferramentas em 57 domínios, mas não envia mais todo esse esquema para a IA em cada conexão. O perfil padrão producer expõe um loop de produção focado em 26 ferramentas, além de search_tools e call_tool; todas as outras ferramentas permanecem pesquisáveis e diretamente chamáveis pelo nome. Isso mantém o catálogo inicial abaixo de 40 KB enquanto preserva o sistema completo.

Use LIVEPILOT_TOOL_PROFILE=composition, mixing ou sampling para fixar mais ferramentas de domínio. Defina LIVEPILOT_TOOL_PROFILE=full para clientes legados ou diagnósticos de catálogo. Destaques abaixo — catálogo completo aqui.

Controle Principal do Ableton — destaques

Ponte M4L — 38 ferramentas de análise [optional], 32 comandos de ponte

O Analisador M4L fica na faixa master. UDP 9880 transporta dados espectrais para o servidor. OSC 9881 envia comandos de volta. O pré-voo ensure_analyzer_on_master (v1.20.3) carrega o analisador de forma idempotente quando uma decisão dependente de áudio precisa dele.

[!TIP] A maioria das ferramentas funciona sem o analisador — ele adiciona 38 ferramentas espectrais/de análise (frequência, loudness, percepção, Simpler, warp) e fecha o loop de feedback.

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 ferramentas

O atlas é um banco de dados indexado em memória de toda a biblioteca de dispositivos do 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 — Extensões locais do usuário: Coloque arquivos YAML em ~/.livepilot/atlas-overlays/<namespace>/ para estender o atlas com bibliotecas de hardware personalizadas, chains de assinatura ou receitas de técnicas — sobrevive a atualizações do npm. Veja docs/EXTENSION_API.md.

v1.23.4 — Fases C/D/E/F do Pack-Atlas: Seis novas ferramentas de orquestração orientadas por corpus transformam os 3.917 sidecars de packs analisados + 104 parses de .als de demonstração em artefatos acionáveis — encontre presets semelhantes, transplante estéticas entre BPM/escala/gênero, narre uma demo, extraia a chain de uma faixa como um plano executável, inicialize composições coerentes com o pack, execute qualquer uma das 15 receitas de workflow entre packs. Toda execução é dry-run por padrão — retorna planos, não muta automaticamente a sessão.

Corpus do Usuário — 14 ferramentas [v1.23.4+]

Por que isso existe. O atlas de fábrica cobre o que o Ableton entrega. A maioria dos estúdios também tem plugins de terceiros, dispositivos Max for Live, racks personalizados, presets e packs de samples. O construtor de corpus indexa essa biblioteca local para que as recomendações possam usar ferramentas que você realmente possui.

O construtor de corpus transforma o que está instalado na sua máquina em contexto de produção pesquisável:

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).

O resultado fica em ~/.livepilot/atlas-overlays/user/plugins/<plugin_id>/identity.yaml e está disponível para atlas_search, atlas_chain_suggest, atlas_macro_fingerprint e atlas_describe_chain junto com o atlas de fábrica. Cada resultado nomeia sua fonte (factory_atlas ou user_overlay:user), para que você possa ver se uma recomendação vem do estoque do Ableton ou do seu próprio equipamento.

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 que isso importa. Um índice estático fica desatualizado quando sua biblioteca muda. Reescaneie após adicionar um plugin ou rack e o LivePilot pode considerá-lo junto com os dispositivos de fábrica do Ableton.

Início 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

Veja docs/USER_CORPUS_GUIDE.md para o passo a passo completo, docs/PLUGIN_KNOWLEDGE_ENGINE.md para os internals do engine e livepilot/skills/livepilot-corpus-builder/SKILL.md para a skill de agente que conduz o pipeline.

Sample Engine — 23 ferramentas

Pesquise no Ableton, em pastas locais e no Splice juntos, depois classifique os resultados contra o papel musical em vez de retornar uma pilha de nomes de arquivos.

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

Integração Splice

O LivePilot lê o banco de dados SQLite local do Splice para pesquisar seus samples baixados com metadados completos. Nenhuma chave de API é necessária — ele lê o arquivo de banco de dados diretamente.

O que faz:

• Pesquisa seus samples do Splice baixados com metadados de tonalidade, BPM, gênero e tags
• Integra-se como uma terceira fonte junto com o navegador do Ableton e a varredura do sistema de arquivos
• Funciona sem assinatura do Splice — quaisquer samples baixados anteriormente são pesquisáveis

Como funciona: O SpliceSource do Sample Engine lê ~/Library/Application Support/com.splice.Splice/users/default/*/sounds.db — o catálogo SQLite local do Splice de samples baixados. Somente leitura, sem chamadas de rede.

Requisitos: Aplicativo desktop do Splice em execução (o servidor MCP fala com ele via gRPC em uma porta dinâmica anunciada via port.conf, com TLS autoassinado). Para pesquisa totalmente offline, samples baixados anteriormente são sempre pesquisáveis via fallback SQLite local, mesmo que o aplicativo do Splice não esteja em execução.

Composer — três modos (v1.25.0)

Workflow de composição de prompt para plano. Três modos compartilham as mesmas verificações de segurança: reconectar a ponte, carregar o analisador quando necessário, definir o monitoramento corretamente em novas faixas e retornar à Visão de Arranjo após a construção. O trabalho permanece visível como uma sequência de chamadas de ferramentas.

"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

Esboço de loop rápido. Cena única na visão de sessão. Destinado a esboçar ideias rapidamente.

• Ordem de busca: chains .adg curadas do navegador primeiro, dispositivos do atlas em segundo, instrumentos nus apenas como último recurso
• Reparo de afinação de papel de bateria incluído (raiz padrão do Simpler vs. offset MIDI 36)
• 4 padrões de gênero: house, techno, trap, ambient (gêneros desconhecidos caem em um plano de camadas neutro)
• Invoque com: "Faça um loop de [gênero] a [tempo] BPM"

modo completo — compose_full_apply

Faixa completa com forma de música: intro, verso, hook, breakdown, outro. Usa um fluxo de brief criativo LLM em duas fases — o LLM autora a forma (seções, lista de faixas, variantes por seção); o framework fornece o vocabulário (ordem de busca de dispositivos, regras de geração MIDI, convenções de arranjo).

• Variantes MIDI por seção evitam tiles repetidos no arranjo
• Clipes de arranjo nativos via create_native_arrangement_clip (um clipe por seção, em loop para preencher o comprimento da seção)
• Limpeza de faixas zumbis no pós-voo (remove faixas sem clipes e sem dispositivo de instrumento)
• Reparo de afinação de papel de bateria portado do modo rápido
• Âncoras do atlas: conhecimento de dispositivos em nível de papel é fornecido via KnowledgePack.atlas_anchors, que consulta o atlas indexado em vez de correspondência de nomes de arquivos. O campo mais antigo atlas_candidates_per_role é um stub legado obsoleto, mantido vazio para compatibilidade reversa.
• Invoque com: "Escreva uma faixa completa de [gênero] a [tempo] BPM" ou "Construa um arranjo completo"

modo desenvolver — develop_apply

Estende um loop existente de 8 compassos sem perturbar o material original.

• Introspecta a sessão existente (classifica faixas por nome e conteúdo)
• Puxa referências artísticas e estilísticas do prompt do usuário
• Escreve variantes por faixa e novas camadas de suporte junto com o material original
• Invoque com: "Desenvolva este loop" ou "Estenda o que está aqui em uma ideia mais longa"

Scaffolding KnowledgePack (v1.25.0)

Todos os três modos compartilham um KnowledgePack que fornece contexto criativo estruturado em tempo de execução:

• event_lexicon — 42 eventos estruturais em 7 categorias (densidade de bateria, harmonia, textura, vocal, sensação rítmica, tensão, gesto de fx)
• genre_context — analisa o genre-vocabularies.md de 15 gêneros no momento do carregamento
• artist_context — analisa o artist-vocabularies.md de ~25 produtores no momento do carregamento
• atlas_anchors — âncoras de dispositivos do atlas indexado por papel (substituiu o stub legado atlas_candidates_per_role)

Ferramentas principais do composer

• compose — planeja uma composição multicamadas a partir de prompt de texto (ponto de entrada, agnóstico de modo)
• compose_fast_apply — executa o modo rápido diretamente
• compose_full_apply — executa o modo completo diretamente
• develop_apply — executa o modo desenvolver diretamente
• augment_with_samples — planeja camadas baseadas em samples para uma sessão existente
• get_composition_plan — pré-visualização dry-run (veja o plano sem verificações de crédito)

Device Forge — 3 ferramentas

Gere dispositivos de efeitos de áudio M4L a partir de modelos gen~ e instale-os no navegador do Ableton.

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

Planejamento, Avaliação e Aprendizado — 79 ferramentas

Essas ferramentas leem a sessão, diagnosticam problemas, planejam mudanças, comparam resultados e carregam contexto útil para a próxima decisão.

Ver todas as 474 ferramentas →

Instalação

Claude Desktop: instalação em um clique

Baixe o livepilot-<version>.mcpb mais recente na página de Releases e clique duas vezes nele. O Claude Desktop instala tudo automaticamente. Depois:

1. Abra o Ableton Live 12
2. Preferences → Link, Tempo & MIDI → Control Surface → LivePilot
3. Comece a conversar

[!TIP] A Extensão Desktop instala automaticamente o Remote Script e o M4L Analyzer no primeiro lançamento.

Terminal: configuração com um comando

npx livepilot --setup

Executa o assistente de configuração completo: verifica o Python, instala o Remote Script, cria o ambiente Python, copia o M4L Analyzer e testa a conexão com o Ableton.

Manual: passo a passo

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"] }
  }
}

Verificação

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 — lida com trabalhos mais longos em etapas visíveis: lê a sessão, verifica o que você manteve, pesquisa a biblioteca, propõe um plano, aplica edições e escuta de volta. Você permanece no controle do que permanece no set.

Core Skill — mantém o trabalho disciplinado: pesquisar antes de carregar, medir antes e depois, preservar o undo e verificar cada mudança.

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

Compatibilidade

Níveis de versão:

• Core (12.0+): Todas as ferramentas de sessão, mixagem, dispositivos, MIDI, teoria, generativo, memória
• Enhanced Arrangement (12.1.10+): Clipes de arranjo nativos, automação de arranjo
• Full Intelligence (12.3+): insert_device_native, pipeline completo de inserção de dispositivos
• Collaborative (12.4+): replace_sample_native e rotas mais novas de edição de samples que contornam o fallback M4L quando o Live expõe um caminho LOM nativo

Desenvolvimento

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

Veja CONTRIBUTING.md para detalhes de arquitetura, diretrizes de código e como adicionar ferramentas.

Documentação

Comunidade

• Discussões — perguntas, ideias, mostre e conte
• Relatórios de bugs
• Solicitações de recursos
• Guia de contribuição
• Política de segurança

Suporte

LivePilot é de código-fonte disponível sob a Business Source License 1.1. Se ele conquistar um lugar em suas sessões, você pode apoiar seu desenvolvimento contínuo:

Patrocinar no GitHub

O patrocínio financia cobertura mais profunda do Ableton, testes multiplataforma e bibliotecas de técnicas mantidas. Patrocinadores também recebem builds antecipados e suporte direto.

BSL-1.1 — Pilot Studio

Projetos irmãos: TDPilot (TouchDesigner) · ComfyPilot (ComfyUI)