FL YuE2: ComfyUI で YuE2 向けピアノロール音楽スタジオ

このノードパックが追加するもの

ComfyUI は今月初めにネイティブの YuE2 サポートを実装し、歌詞から楽曲を生成する機能と ABC 譜面の条件付けに対応しました。FL YuE2 はその上に制作レイヤーを構築します。歌詞とスタイルから楽曲を作曲し、ABC 譜面を作成またはインポートし、YuE2-3B で 48 kHz ステレオ音声をレンダリングできます。ノードは ComfyUI の標準的な音声プレビュー、保存、処理ノードに接続でき、このノードパックは上流の YuE2 パッケージをインストールする代わりに、ComfyUI に既存の Torch インストールを利用します。

ノード構成は小規模でリニアです。

• Load Models は YuE2-3B モデルと別個の音声デコーダ（初回実行時に約 7.8 GB）を ComfyUI/models/yue2/ に取得します。レジューム機能と重みマニフェストの検証に対応しています。
• Compose は音楽スタイル、[Verse] / [Chorus] セクションを含む歌詞、プランニングモード、シードを受け取り、ABC 譜面を出力します。
• Render Music は音楽トークンと音響潜在を生成します。acoustic_steps=32 は公開されている中点ソルバーに一致します。
• Decode Audio は通常の ComfyUI AUDIO を返します。tile_frames オプションでデコーダのメモリ使用量を削減できます。

ピアノロールが最大の売り

際立った要素は 譜面エディタワークフローです。YuE2 の ABC に基づく MIDI スタイルのピアノロールで、2 つのモノフォニックなメロディレーンと、独立したコードレーンを備えています。ノートをドラッグし、エディタを Compose の score_abc 入力に接続すると、描いたとおりのメロディがレンダリングされます。2 つのモノフォニックメロディとコードレーンが現在の対応範囲で、MIDI ファイルのインポートと音声のトランスクリプションは含まれません。

プランニングモードはこれにきれいに対応します。full はメロディとコードを生成し、melody は伴奏をより自由に残し、off は記号譜面を完全にスキップします。変更していないコンポジションはコンポジションソケットを通じてトークンのプレフィックスを正確に維持するため、固定シードで再レンダリングすると同じテイクが再現されます。ABC 譜面を指定した場合は譜面生成がバイパスされ、full または melody の指示が保持されます。また、空の歌詞がプランニングの選択を上書きすることはありません。これは、スタイルフィールドで楽器編成を記述するインストゥルメンタルのプロンプトに役立ちます。

AR LoRA トレーニングを内蔵

このノードパックには YuE2 AR LoRA トレーナーも同梱されています。レビュー済みデータセット、チェックポイントのプレビュー、そして同じエンコーダ上で ComfyUI 内で実行されるトレーニングループです。これにより、アプリから離れることなくスタイル参照からカスタムボイスやジャンルのアダプタまでのループが完結します。これは現在、他のどの YuE2 統合も実現していません。

ワークフロー

譜面エディタから楽曲へのサンプルは、Piano Roll → Compose → Render Music → Decode Audio → Preview/Save を共有モデルローダーで接続します。

入手方法

ComfyUI-FL-YuE2 は ComfyUI Manager からインストールするか、filliptm/ComfyUI-FL-YuE2 を ComfyUI/custom_nodes にクローンし、ComfyUI 環境で pip install -r requirements.txt を実行してください。Comfy Kitchen の split-half RMS/RoPE 演算に対応した最新の ComfyUI と、BF16 対応の NVIDIA GPU が必要です。作者は Windows 上の RTX PRO 6000 Blackwell で検証しており、24 GB 構成は未検証です。YuE2-3B は m-a-p チームによる研究用ライセンス（CC-BY-NC-4.0）のままです。