livepilot

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

変化を加え、何が起きたかを聴き、うまくいったものを残しましょう。
LivePilot は AI クライアントを Ableton Live 12 に接続します。アイデアをスケッチし、セットを編集し、バージョンを比較して、残した選択から学びましょう。

474 個のツール · 57 のドメイン · macOS + Windows

メモ

LivePilot は、Claude Code、Claude Desktop、Codex、 Cursor、VS Code、Windsurf など、あらゆる MCP クライアントで動作します。Live セット内の変更には Ableton の取り消し履歴が適用されます。 ダウンロード、保存したメモリ、ライブラリのスキャン、インストーラーによる変更はセットの外で行われるため、 Ableton から取り消すことはできません。

警告

LivePilot は急速に更新されています。スタジオやライブパフォーマンスで再現性のある環境を整えるには、バージョンを固定し、 更新前に変更履歴を確認してください。

まずはこちら

セットアップウィザードは Ableton Remote Script をインストールし、Python 環境を作成して、 Max for Live Analyzer をコピーし、接続を確認します。

npx livepilot --setup

Claude Desktop をお使いですか？リリースから最新の livepilot-<version>.mcpb をダウンロードして、ダブルクリックしてください。

クライアントごとのセットアップ方法と手動オプションについては、インストールをご覧ください。

v1.30.0 の新機能

LivePilot は自己紹介に使うコンテキストを大幅に減らし、実際に把握している内容について、より明確に回答できるようになりました。

• 最初のやり取りをすっきりと。 通常のセッションでは、474 個すべてのスキーマを一度に送信する代わりに、役立つ 28 個の入口を案内します。残りも引き続き検索して直接呼び出せます。
• 意味のあるオプション。 Composer、Atlas、ルーティングの装飾的なパラメーターを削除しました。サンプルの役割と素材フィルターが結果に反映されるようになり、サポートされていない抽象的なイベントには、何も起きないまま終わるのではなく、具体的なガイダンスが表示されます。
• ラベル付きの根拠。 ミックスと評価のレポートでは、音声の測定値、セットアップから導いたヒューリスティック、芸術的な判断を区別します。「明るさを抑える」などの目標も、適切な方向で評価されるようになりました。
• 必要なときに深く。 素早いクリエイティブなリクエストには、素早い処理を適用します。3 方向の探索、広範なメモリの読み込み、批評の全工程は、実際に曖昧さがある場合に限って行われます。
• より安定したセッション。 起動時にオプションのサービスを待つ必要がなくなりました。ネットワーク障害の原因が曖昧な場合も、破壊的な編集を再実行しません。また、プロジェクトのメモリは Live セットに紐づき、セット内の通常の編集には左右されません。

前回のリリース v1.29.0 では、学習した知覚的な好み、信頼度に関する誠実なゲート、オプションの CLAP 距離、名前付きのアレンジメントロケーターが導入されました。

詳細は変更履歴をご覧ください。

LivePilot の機能

LivePilot は 2 つのレベルで動作します。やりたいことが分かっている場合は正確に操作でき、分からない場合は情報に基づいてサポートします。

内部には、5,264 台のデバイスのアトラス、683 種類のマッピング済みドラムキット、29 種類のサンプル処理技法、44 種類の意味ベースの操作、リアルタイムおよびオフラインのリスニング、12 種類の計画・評価システムがあります。以下のセクションでは、それぞれの仕組みを説明します。

LivePilot との 2 つの話し方

その場に合った言葉で始めましょう。どちらの方法でも、同じツール群を利用できます。

方法 A — アーティスト／美的感覚の略式表現

「J Dilla っぽいサウンドにして。」   「もっと Burial らしい雰囲気にして。」   「BoC 風のパッド。」

プロデューサーやジャンルを、リズム、密度、空間、質感、デバイスの選択を伝える略式表現として使います。LivePilot は、誰かの個性を複製すると装うのではなく、その参照を技法に置き換えます。

方法 B — 音楽的な意図を直接伝える

「スネアを 4 ms 早めて、キックはグリッドに合わせたまま、ハイハットに ±2 ms のタイミングのばらつきを加え、スネアの 380 Hz 付近を 3 dB カットして。」

細部が重要な場合は、ノート、ミリ秒、dB、周波数、モジュレーションの深さ、エンベロープの形状、センドレベル、オートメーションカーブ、スケール上の度数、またはボイスリーディングを具体的に指定します。

2 つの方法を組み合わせる

多くのセッションでは、両方を使います。大まかな指示から始めて、聴きながら、トラックに必要な箇所を具体的に指定します。

アーキテクチャ

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

各要素の連携方法

リモートスクリプト（remote_script/LivePilot/）— Ableton のプロセス内で実行される Python ControlSurface です。TCP 9878 で待ち受けます。すべての Live Object Model 呼び出しは、schedule_message を介して Ableton のメインスレッドで実行されます。起動時に Ableton のバージョンを検出し、4 つの機能ティアを有効にします。Core（12.0+）、Enhanced Arrangement（12.1.10+）、Full Intelligence（12.3+）、Collaborative（12.4+）です。

MCP サーバー（mcp_server/）— Python FastMCP サーバーです。入力を検証し、TCP 経由でリモートスクリプトにコマンドをルーティングし、M4L ブリッジを管理するとともに、アトラス、サンプルエンジン、コンポーザー、計画・評価システムを実行します。AI クライアントはここに接続します。

M4L ブリッジ（m4l_device/）— マスタートラックに配置するオプションの Max for Live Audio Effect です。ControlSurface API ではアクセスできない深い LOM アクセスを、Max の LiveAPI を通じて提供します。UDP 9880（M4L からサーバー）はスペクトルデータと LiveAPI の応答を転送します。OSC 9881（サーバーから M4L）はコマンドを送信します。38 種類のスペクトル／アナライザーツールにはブリッジが必須です。ブリッジを呼び出すデバイスおよびサンプルツールには正常なフォールバックも用意されているため、ブリッジなしでもコア機能を利用できます。Python からアクセスできない子オブジェクト上にある隠しパラメーター、Simpler の内部機能、ワープマーカー、表示値、Simpler のワープ設定／Compressor のサイドチェイン書き込みに対応する 32 種類のブリッジコマンドを備えています。 Device Atlas（mcp_server/atlas/）— インメモリのインデックス付き JSON データベースです。ブラウザー URI を持つデバイスを 5264 件（同梱のベースライン）、YAML の音響プロファイル（ムード、ジャンル、テクスチャ、推奨チェーン）で拡充したデバイスを 120 件収録しています。インデックスは 7 種類です：by_id、by_name、by_uri、by_category、by_tag、by_genre、by_pack。逆引きインデックス device_techniques_index.json は、58 台のデバイスにわたる 146 件の相互参照を持つ atlas_techniques_for_device を支えます。デバイスとプリセットの選択は、読み込み前にアトラスと照合されるため、推測による名前や行き詰まりが減ります。v1.22.0+：インストール後に scan_full_library を実行すると、パック、User Library、プラグインが ~/.livepilot/atlas/device_atlas.json にインデックス化されます。個人用アトラスはベースラインより優先され、npm の更新後も保持されます。

Sample Engine（mcp_server/sample_engine/）— 3 つのソースを同時に検索します。BrowserSource（Ableton のライブラリ）、SpliceSource（SQLite 経由のローカル Splice カタログ）、FilesystemSource（ユーザーディレクトリ）です。すべての検索結果は、6 つの評価項目による適合性チェック（キー、テンポ、スペクトル、ジャンル、ムード、技術面）を通過します。29 種類の処理テクニック（Surgeon の精密さと Alchemist の実験性）を備えています。ワープ、スライス、エフェクトの推奨を含む、サンプル処理の完全なプランを作成します。

Splice Client（mcp_server/splice_client/）— 2 つのレイヤーを通じて Splice のカタログを検索します。ローカルの SQLite データベース（sounds.db、すでにダウンロード済みのサンプル）と、ライブ gRPC API（まだダウンロードしていないサンプルも含む完全なカタログ）です。gRPC クライアントは port.conf を通じて Splice の動的ポートを自動検出し、自己署名 TLS を処理するとともに、ダウンロード前に 5 クレジットの安全下限を適用します。呼び出しごとのタイムアウト（5～10 秒）により、Splice プロセスが応答しなくても MCP イベントループが停止しません。grpcio がインストールされていない場合は、SQL のみを使う方式に適切にフォールバックします。API キーは不要です。認証には実行中の Splice デスクトップアプリを使用します。

Composer（mcp_server/composer/）— プロンプトからプランを作成するパイプラインです。自然言語（「暗くミニマルなテクノ、128bpm、インダストリアルなテクスチャ」など）を CompositionIntent（ジャンル、ムード、テンポ、キー）に解析します。役割テンプレート（キック、ベース、パーカッション、テクスチャ、リード、パッド、FX）を使ってレイヤーを計画します。エージェントが実行するツール呼び出しの手順をまとめたプランにコンパイルします。自律的には実行せず、プランを返します。ジャンルのデフォルトは 4 種類（ハウス、テクノ、トラップ、アンビエント）です。このセットにないジャンルの場合は、中立的なレイヤープランにフォールバックします。

Corpus（mcp_server/corpus/）— 解析したデバイス知識の Markdown を、クエリ可能な Python 構造（EmotionalRecipe、GenreChain、PhysicalModelRecipe、AutomationGesture）に変換します。実行時に、構造化された制作リファレンスを Wonder Mode、Sound Design の評価機能、Composer に提供します。

Execution Router（mcp_server/runtime/execution_router.py）— 複数ステップの各プランを remote_command（Ableton への TCP）、bridge_command（M4L への OSC）、mcp_tool（内部処理）に分類し、適切なチャネルを通じてディスパッチします。

LivePilot が判断を下す仕組み

編集を行うのはツールです。以下の 12 のシステムが、何を試すか、何を保護するか、何を比較するか、何を記憶するかの判断を支えます。

SongBrain — 曲の状態

セッションのリアルタイムモデルを構築します。アイデンティティの中核（このトラックを定義する要素）、大切に守る要素（軽々しく損なってはならない要素）、セクションの目的（各パートが感情面で果たす役割）、エネルギーの流れ（曲がどこへ向かっているか）を把握します。編集によってトラックの良さが失われていくと、アイデンティティのずれを検出します。

Taste Graph — 好みの傾向

セッションを通じて、制作上の好みを学習します。繰り返し採用する変更の種類と取り消す変更の種類、よく使うデバイス、提案に求める実験性（新規性の範囲）、避ける傾向のある要素を追跡します。採用または却下するたびにグラフが更新されます。同じツールを使う 2 人のプロデューサーにも、それぞれ異なる推奨が提示されます。

セマンティックムーブ — パラメーターではなく、音楽的なアクション

7 つのファミリー（ミックス、アレンジ、トランジション、サウンドデザイン、パフォーマンス、デバイス作成、サンプル）にわたる44 個の高レベルな意図（「コントラストを加える」「低域を引き締める」「キックとベースをかみ合わせる」「ボーカルのゴーストをサンプリングする」「壊してから再構築する」など）があります。各ムーブは、リスクレベル、対象の次元、保護しきい値を含む具体的なツールシーケンスにコンパイルされます。アナライザーが必要なムーブ（tighten_low_end、make_kick_bass_lock）では、スペクトルの事前読み取りが任意として指定されるため、アナライザーを利用できない場合でもプランは続行します。何かを変更する前に、プランでトレードオフを確認できます。

ワンダーモード — 行き詰まりを解消するワークフロー

セッションが行き詰まったとき（アンドゥの繰り返し、磨き込みすぎたループ、構成の進展がない状態）、ワンダーモードが起動します。

1. 診断 — 行き詰まりの種類を分類します（ループの罠？ コントラストの不足？ アイデンティティが不明確？）
2. 生成 — 診断に対処するセマンティックムーブを探し、実質的な違いを強制します
3. プレビュー — 各バリエーションを適用してキャプチャし、アンドゥします。確定する前に試聴できます
4. 確定または却下 — 選択内容が、好みとセッションの継続性に記録されます

クリエイティブエンジン

フックハンター

最も際立つ音楽的アイデアを特定し、シーンをまたいだ反復、モチーフの顕著さ、セクション内の配置（ペイオフとなるセクションへの加点）に基づいて候補に順位を付けます。フックが展開されているか、放置されているか、損なわれているかを追跡し、トランジションが期待されるペイオフを生み出せなかった場合に通知します。リズムに基づくランキングは現在ヒューリスティックです（ドラムトラックの検出とクリップの再利用）。オンセットに基づく本格的なリズム特徴量は、今後のロードマップに含まれています。

セッションの継続性

セッション全体を通じて、クリエイティブなテーマ（「コーラスにもっと高揚感が必要」など）とターンごとの解決状況を維持します。プロジェクトに戻ると、次のように表示されます。「前回は、ブリッジにフィルタースイープを残しました。コーラスの高揚感に関するテーマは、まだ未解決です。」

評価ループ

すべてのエンジンは、変更前に測定 → 実行 → 変更後に測定 → 比較の手順に従います。変更によって状態が悪化した場合（マスキングの増加、ヘッドルームの喪失、アイデンティティのずれ）、次に進む前にシステムが通知します。

ツール

LivePilot には 57 のドメインにわたる 474 個のツールがありますが、接続のたびにそのスキーマ全体を AI に送信することはありません。デフォルトの producer プロファイルでは、制作に特化した 26 個のツールからなるワークフローに加えて、search_tools と call_tool を利用できます。それ以外のツールもすべて検索でき、名前を指定して直接呼び出せます。これにより、システム全体の機能を維持しながら、初期カタログを 40 KB 未満に抑えています。

LIVEPILOT_TOOL_PROFILE=composition、mixing、または sampling を使用すると、より多くのドメインツールを固定できます。従来のクライアントやカタログの診断では、LIVEPILOT_TOOL_PROFILE=full を設定してください。以下に主な機能を紹介します。 — 完全なカタログはこちら。

M4L ブリッジ — 38 個のアナライザーツール [optional]、32 個のブリッジコマンド

M4L Analyzer はマスタートラックに配置されます。UDP 9880 でスペクトルデータをサーバーに送信します。OSC 9881 でコマンドを送り返します。ensure_analyzer_on_master の事前チェック（v1.20.3）は、オーディオに依存する判断で必要になった場合に、アナライザーを冪等に読み込みます。

ヒント

ほとんどのツールはアナライザーなしで動作します。アナライザーを追加すると、38 個のスペクトル／アナライザーツール（周波数、ラウドネス、知覚、Simpler、ワープ）が利用でき、フィードバックループが完成します。

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

デバイスアトラス — 13 個のツール

アトラスは、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 — ユーザー領域の拡張機能： ~/.livepilot/atlas-overlays/<namespace>/ に YAML ファイルを配置すると、カスタムハードウェアライブラリ、シグネチャーチェーン、テクニックレシピを追加してアトラスを拡張できます。npm の更新後も保持されます。詳しくは docs/EXTENSION_API.md を参照してください。

v1.23.4 — Pack-Atlas のフェーズ C/D/E/F： コーパスに基づく新しい 6 つのオーケストレーションツールにより、解析済みの 3,917 個のパックのサイドカーと 104 個のデモ .als の解析結果を、実用的な成果物に変換できます。類似プリセットの検索、BPM／スケール／ジャンルをまたいだ美学の移植、デモのナレーション、トラックのチェーンの実行可能なプランとしての抽出、パックの一貫性を保った作曲の初期設定、15 種類のパック横断ワークフローレシピの実行が可能です。すべての実行はデフォルトでドライランとなり、プランを返すだけで、セッションを自動変更することはありません。

これが必要な理由。 ファクトリーアトラスでは、Ableton が提供するものを網羅しています。多くのスタジオには、サードパーティ製プラグイン、Max for Live デバイス、カスタムラック、プリセット、サンプルパックもあります。コーパスビルダーは、そうしたローカルライブラリをインデックス化し、実際に所有しているツールを使ってレコメンデーションを作成できるようにします。

コーパスビルダーは、マシンにインストールされているものを検索可能な制作コンテキストに変換します。

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

結果は ~/.livepilot/atlas-overlays/user/plugins/<plugin_id>/identity.yaml に保存され、ファクトリーアトラスと並んで atlas_search、atlas_chain_suggest、atlas_macro_fingerprint、atlas_describe_chain から利用できます。各結果にはソース（factory_atlas または user_overlay:user）が表示されるため、レコメンデーションが Ableton の標準機能によるものか、自分の機材によるものかを確認できます。

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

これが重要な理由。 ライブラリを変更すると、静的なインデックスは古くなります。プラグインやラックを追加した後に再スキャンすれば、LivePilot はそれらも Ableton のファクトリーデバイスと合わせて検討できます。

クイックスタート：

# 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

詳しい手順については docs/USER_CORPUS_GUIDE.md、エンジンの内部構造については docs/PLUGIN_KNOWLEDGE_ENGINE.md、パイプラインを実行するエージェントスキルについては livepilot/skills/livepilot-corpus-builder/SKILL.md を参照してください。

サンプルエンジン — 23 ツール

Ableton、ローカルフォルダー、Splice をまとめて検索し、ファイル名の一覧を返すのではなく、音楽的な役割に照らして結果をランク付けします。

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

Splice 連携

LivePilot は Splice のローカル SQLite データベースを読み込み、ダウンロード済みサンプルを詳細なメタデータで検索します。API キーは不要です。データベースファイルを直接読み取ります。

機能：

• キー、BPM、ジャンル、タグのメタデータを使って、ダウンロード済みの Splice サンプルを検索します
• Ableton のブラウザーおよびファイルシステムのスキャンと並ぶ、3 つ目の検索元として統合します
• Splice のサブスクリプションがなくても動作します。以前ダウンロードしたサンプルは検索できます

仕組み： サンプルエンジンの SpliceSource は ~/Library/Application Support/com.splice.Splice/users/default/*/sounds.db を読み取ります。これはダウンロード済みサンプルの Splice ローカル SQLite カタログです。読み取り専用で、ネットワーク呼び出しはありません。

要件： Splice デスクトップアプリが起動していること（MCP サーバーは、port.conf で通知される動的ポートを介し、自己署名 TLS を使用して gRPC で通信します）。完全にオフラインで検索する場合は、Splice アプリが起動していなくても、ローカル SQLite フォールバックによって以前ダウンロードしたサンプルを常に検索できます。

Composer — 3 つのモード（v1.25.0）

プロンプトからプランを作成するコンポジションワークフローです。3 つのモードすべてで同じ安全チェックを実施します。ブリッジの再接続、必要に応じたアナライザーの読み込み、新しいトラックのモニタリング設定、ビルド後の Arrangement View への復帰を行います。作業の内容は、ツール呼び出しのシーケンスとして確認できます。

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

fast モード — compose_fast_apply

手早くループのラフ案を作成します。セッションビューで単一のシーンを使います。アイデアを素早く形にするためのモードです。

• 選択順：まずブラウザーのキュレーション済み .adg チェーン、次にアトラスのデバイス、最後の手段として単体のインストゥルメント
• ドラムの役割に応じたピッチ補正を含みます（Simpler のデフォルトルートと MIDI 36 のオフセット）
• ジャンルのデフォルトは 4 種類です：house、techno、trap、ambient（不明なジャンルの場合はニュートラルなレイヤープランにフォールバックします）
• 次のように呼び出します：「[tempo] BPM の [genre] ループを作って」

フルモード — compose_full_apply

曲の構成に沿ったフルモードです。イントロ、ヴァース、フック、ブレイクダウン、アウトロで構成されます。2段階のLLMクリエイティブブリーフフローを使用します。LLMが構成（セクション、トラックリスト、セクションごとのバリエーション）を作成し、フレームワークが語彙（デバイスの探索順序、MIDI生成ルール、アレンジの慣例）を提供します。

• セクションごとのMIDIバリエーションにより、アレンジ全体で同じタイルが繰り返されるのを防ぎます
• create_native_arrangement_clip によるネイティブのアレンジクリップ（セクションごとに1つのクリップを作成し、セクションの長さに合わせてループします）
• ポストフライトでゾンビトラックをクリーンアップします（クリップもインストゥルメントデバイスもないトラックを削除します）
• ファストモードから移植したドラムロールのピッチ修正
• Atlas アンカー： ロールレベルのデバイス情報は KnowledgePack.atlas_anchors を通じて提供され、ファイル名の照合ではなく、インデックス化されたアトラスを参照します。旧来の atlas_candidates_per_role フィールドは非推奨のレガシースタブとして、後方互換性のために空のまま維持されています。
• 次のように指定して呼び出します：「[テンポ] BPMでフルの[ジャンル]トラックを書いて」 または 「フルアレンジを作って」

デベロップモード — develop_apply

シード素材に影響を与えずに、既存の8小節ループを展開します。

• 既存のセッションを調査します（名前と内容に基づいてトラックを分類します）
• ユーザーのプロンプトからアーティストやスタイルの参照情報を取得します
• シードと並行して、トラックごとのバリエーションと新しい補助レイヤーを作成します
• 次のように指定して呼び出します：「このループを展開して」 または 「ここにある素材を長めのアイデアに発展させて」

KnowledgePack の基盤（v1.25.0）

3つのモードすべてで、実行時に構造化されたクリエイティブコンテキストを提供する KnowledgePack を共有します。

• event_lexicon — 7カテゴリ（ドラムの密度、ハーモニー、テクスチャ、ボーカル、リズムの感触、緊張感、FXジェスチャー）にわたる42の構造イベント
• genre_context — 読み込み時に15ジャンルの genre-vocabularies.md を解析します
• artist_context — 読み込み時に約25人のプロデューサーを収録した artist-vocabularies.md を解析します
• atlas_anchors — ロールごとのインデックス化されたアトラスのデバイスアンカー（レガシーの atlas_candidates_per_role スタブを置き換えました）

コンポーザーのコアツール

• compose — テキストプロンプトから複数レイヤーのコンポジションを計画します（モードに依存しないエントリーポイント）
• compose_fast_apply — ファストモードを直接実行します
• compose_full_apply — フルモードを直接実行します
• develop_apply — デベロップモードを直接実行します
• augment_with_samples — 既存のセッション向けにサンプルベースのレイヤーを計画します
• get_composition_plan — ドライランのプレビューを表示します（クレジットチェックなしでプランを確認できます）

Device Forge — 3つのツール

gen~ テンプレートから M4L オーディオエフェクトデバイスを生成し、Ableton のブラウザーにインストールします。

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

これらのツールはセッションを読み取り、問題を診断し、変更を計画し、結果を比較して、次の判断に役立つコンテキストを引き継ぎます。

474 個すべてのツールを見る →

インストール

Claude Desktop：ワンクリックインストール

リリースページから最新のlivepilot-<version>.mcpbをダウンロードし、ダブルクリックします。 Claude Desktop がすべてを自動でインストールします。その後、次の操作を行います。

1. Ableton Live 12 を開きます
2. 環境設定 → Link、Tempo & MIDI → コントロールサーフェス → LivePilot
3. チャットを開始します

ヒント

デスクトップ拡張機能は、初回起動時に Remote Script と M4L Analyzer を自動インストールします。

ターミナル：1 コマンドでセットアップ

npx livepilot --setup

セットアップウィザードを実行します。Python の確認、Remote Script のインストール、Python 環境の作成、M4L Analyzer のコピー、Ableton 接続のテストを行います。

手動設定：ステップごと

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

確認

npx livepilot --status

プラグイン

Codex App

npx livepilot --install-codex-plugin

Claude Code

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

プロデューサーエージェント — 長めの作業を、見える段階に分けて処理します。セッションを読み込み、残した内容を確認し、ライブラリを検索して計画を提案し、編集を適用してから再生して確認します。セットに何を残すかは、引き続きユーザーが決めます。

コアスキル — 検索してから読み込み、変更の前後に測定し、元に戻せる状態を保ち、すべての変更を検証することで、作業を規律あるものにします。

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

互換性

バージョン別の機能：

• コア（12.0 以降）： すべてのセッションツール、ミキシング、デバイス、MIDI、音楽理論、生成機能、メモリー
• 拡張アレンジ（12.1.10 以降）： ネイティブのアレンジメントクリップ、アレンジメントオートメーション
• 完全なインテリジェンス（12.3 以降）： insert_device_native、完全なデバイス挿入パイプライン
• コラボレーション（12.4 以降）： replace_sample_native と、Live がネイティブ LOM パスを公開している場合に M4L のフォールバックを迂回する、より新しいサンプル編集ルート

開発

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

アーキテクチャの詳細、コードガイドライン、ツールの追加方法については、CONTRIBUTING.md を参照してください。

ドキュメント

コミュニティ

• ディスカッション — 質問、アイデア、作品の紹介
• バグ報告
• 機能リクエスト
• コントリビューションガイド
• セキュリティポリシー

サポート

LivePilotは、Business Source License 1.1のもとでソースコードを公開しています。 セッションで役立つと感じたら、継続的な開発をご支援いただけます。

GitHubでスポンサーになる

スポンサーからのご支援は、Abletonへの対応拡充、クロスプラットフォームテスト、技術ライブラリの保守に活用されます。スポンサーには、早期ビルドと直接サポートも提供されます。

BSL-1.1 — Pilot Studio

関連プロジェクト：TDPilot（TouchDesigner） · ComfyPilot（ComfyUI）