LivePilot

by dreamrec

Not rated
GitHub

About

AI copilot for Ableton Live 12 — 91 MCP tools for real-time music production, sound design, and mixing

Details

Author
dreamrec
Categories
Productivity, Other, AI

Setup

Install LivePilot in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/dreamrec/LivePilot

Follow the installation instructions in the repository README, then restart your MCP client.

M4L Bridge — 38 analyzer tools](https://github.com/dreamrec/LivePilot/blob/HEAD/docs/manual/tool-catalog.md)[optional], 32 bridge commands

The M4L Analyzer sits on the master track. UDP 9880 carries spectral data to the server. OSC 9881 sends commands back. Theensure_analyzer_on_masterpre-flight (v1.20.3) loads the analyzer idempotently on first use — call it once at session start and forget about it.

[!TIP] Most tools work without the analyzer — it adds 38 spectral/analyzer tools (frequency, loudness, perception, Simpler, warp) and closes the feedback loop.

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

The atlas is an in-memory indexed database of Ableton's entire device library.

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 — User-local extensions:Drop YAML files at~/.livepilot/atlas-overlays/<namespace>/to extend the atlas with custom hardware libraries, signature chains, or technique recipes — survives npm updates. Seedocs/EXTENSION_API.md.

v1.23.4 — Pack-Atlas Phases C/D/E/F:Six new corpus-driven orchestration tools turn the 3,917 parsed pack sidecars + 104 demo.alsparses into actionable artifacts — find similar presets, transplant aesthetics across BPM/scale/genre, narrate a demo, extract a track's chain as a runnable plan, bootstrap pack-coherent compositions, run any of 15 cross-pack workflow recipes. All execution is dry-run by default — returns plans, doesn't auto-mutate the session.

Why this exists.The factory atlas (5264 devices, 33 packs) is whatAbleton ships. Your real library is bigger — your VST/AU plugins, your Max for Live devices, your.adgracks, your custom presets, your Splice packs. Without the corpus builder, all of that is invisible to LivePilot. With it, the same query that previously routed to Operator + Saturator can route toyourValhalla Supermassive,yourCHOWTapeModel,yourMoog Model D — because LivePilot now knows what you have, what each tool sounds like, and which producer aesthetics it supports.

The corpus builder is a 4-phase pipeline that turns "what's installed on this Mac" into AI-queryable knowledge:

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. Emit WebSearch task packets for plugin+technique research. Phase 4 — SYNTHESIZE Sonnet subagent dispatch — write per-plugin identity.yaml with sonic_fingerprint / reach_for / avoid / key_techniques / parameter_glossary / comparable_plugins / genre_affinity / producer_anchors. EXACTLY ONE primary format tag (no dual-indexing across formats).

The result lives at~/.livepilot/atlas-overlays/user/plugins/<plugin_id>/identity.yamland is loaded by every reasoning tool —atlas_search,atlas_chain_suggest,atlas_macro_fingerprint,atlas_describe_chain— alongside the factory atlas. Each result is tagged with its source (factory_atlasvsuser_overlay:user), so the agent always knows whether it's recommending Ableton stock or your own gear.

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 — emit WebSearch task packet for the agent corpus_emit_synthesis_briefs Phase 4 — emit sonnet-subagent briefs per plugin

Why versatility outside Ableton matters.A static knowledge base ages out the day you install a new plugin. The corpus builder makes LivePilot's knowledge boundary equal toyour library, notAbleton's library. Every plugin you add can be re-scanned and synthesized in minutes; every saved.adgrack you build can be indexed alongside Ableton's factory chains. The brain becomes specifically yours.

# 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 runs WebSearch corpus_emit_synthesis_briefs # → sonnet writes identity.yamls

Seedocs/USER_CORPUS_GUIDE.mdfor full walk-through,docs/PLUGIN_KNOWLEDGE_ENGINE.mdfor engine internals, andlivepilot/skills/livepilot-corpus-builder/SKILL.mdfor the agent skill that drives the pipeline.

Three-source sample intelligence with critic-driven fitness scoring, plus deep Splice integration (catalog search, preview, collections, preset downloads).

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

LivePilot reads Splice's local SQLite database to search your downloaded samples with full metadata. No API key needed — it reads the database file directly.

- Searches your downloaded Splice samples with key, BPM, genre, and tag metadata
- Integrates as a third source alongside Ableton's browser and filesystem scanning
- Works without a Splice subscription — any previously downloaded samples are searchable

How it works:The Sample Engine'sSpliceSourcereads~/Library/Application Support/com.splice.Splice/users/default//sounds.db— Splice's local SQLite catalog of downloaded samples. Read-only, no network calls.

Requirements:Splice desktop app running (the MCP server talks to it over gRPC at a dynamic port advertised viaport.conf, with self-signed TLS). For fully offline search, previously-downloaded samples are always searchable via the local SQLite fallback even if the Splice app isn't running.

Prompt-to-plan auto-composition engine. Three modes share a common Applier substrate (preflight: bridge handshake retry + analyzer load; postflight: monitoring=Auto on new tracks + back_to_arranger). All modes return executable plans — the agent executes each step, it does not run autonomously.

"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 └─────────────────┘

Quick loop sketch. Single scene in session view. Intended for roughing out ideas quickly.

- Hunt order: curated.adgchains from the browser first, atlas devices second, bare instruments only as last resort
- Drum-role pitch repair included (Simpler default root vs. MIDI 36 offset)
- 4 genre defaults: house, techno, trap, ambient (unknown genres fall back to a neutral layer plan)
- Invoke with:
"Make me a
[genre] loop at [tempo] BPM"

Full track with song form: intro, verse, hook, breakdown, outro. Uses a two-phase LLM-creative brief flow — the LLM authors the form (sections, track list, per-section variants); the framework supplies the vocabulary (device hunt order, MIDI generation rules, arrangement conventions).

- Per-section MIDI variants prevent repeated tiles across the arrangement
- Native arrangement clips viacreate_native_arrangement_clip(one clip per section, looped to fill section length)
- Zombie-track cleanup in postflight (removes tracks with no clips and no instrument device)
- Drum-role pitch repair ported from fast mode
- Atlas anchors:role-level device knowledge is supplied throughKnowledgePack.atlas_anchors, which consults the indexed atlas rather than filename matching. The olderatlas_candidates_per_rolefield is a deprecated legacy stub, kept empty for back-compat.
- Invoke with:
"Write a full [genre] track at [tempo] BPM"or"Build a full arrangement"

Extends an existing 8-bar loop without disturbing the seed material.

- Introspects the existing session (classifies tracks by name and content)
- Pulls artist and stylistic references from the user prompt
- Writes per-track variants and new supporting layers alongside the seed
- Invoke with:
"Develop this loop"or"Extend what's here into a longer idea"*

All three modes share aKnowledgePackthat provides structured creative context at runtime:

- event_lexicon— 42 structural events across 7 categories (drum density, harmonic, texture, vocal, rhythm feel, tension, fx gesture)
- genre_context— parses the 15-genregenre-vocabularies.mdat load time
- artist_context— parses the ~25-producerartist-vocabularies.mdat load time
- atlas_anchors— indexed-atlas device anchors per role (replaced the legacyatlas_candidates_per_rolestub)

- compose— plan a multi-layer composition from text prompt (entry point, mode-agnostic)
- compose_fast_apply— execute fast mode directly
- compose_full_apply— execute full mode directly
- develop_apply— execute develop mode directly
- augment_with_samples— plan sample-based layers for an existing session
- get_composition_plan— dry-run preview (see the plan without credit checks)

Generate M4L audio effect devices fromgen~templates and install them into Ableton's browser.

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

The V2 intelligence layer. These tools analyze, diagnose, plan, evaluate, and learn.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.