ComfyUI-PainterLTXV2:LTXV 高度サンプリング&潜空間準備ノード

AI/ML

概要

ComfyUI-PainterLTXV2は、ComfyUI(ノードベースの画像/映像生成UI)に組み込むためのカスタムノード群で、LTXVワークフロー向けの「高度なサンプリング」と「潜空間準備」機能を追加します。主にPainterSamplerLTXV(外部sigmas対応のサンプラー)とPainterLTXVtoVideo(音声/映像を分離してLTXV向け潜空間を整備するノード)を提供し、映像生成パイプラインで音声トラックと映像トラックを別々に扱う必要があるプロ向け用途を想定しています。READMEは中国語・日本語の説明を含み、ワークフロー例(workflow.json)も同梱されており、導入と試用がしやすい構成です。

GitHub

リポジトリの統計情報

  • スター数: 12
  • フォーク数: 0
  • ウォッチャー数: 12
  • コミット数: 10
  • ファイル数: 4
  • メインの言語: Python

主な特徴

  • PainterSamplerLTXV:外部sigmasを受け入れる高度なサンプラーで柔軟なステップ制御が可能
  • PainterLTXVtoVideo:音声と映像を分離した潜空間準備を行い、映像生成ワークフローに統合
  • ComfyUIノードとして簡単導入:nodes.pyと__init__.pyでノード登録、workflow.jsonで使用例を提供
  • 小規模で集中した実装:必要最小限のファイル構成により拡張やデバッグが容易

技術的なポイント

このリポジトリは、ComfyUI上でのLTXV(Latent Transform eXtended Video?/概念的な音声-映像分離を扱うワークフロー)対応を目指すカスタムノード実装です。技術的には二つの主要機能に分かれます。まずPainterSamplerLTXVは、外部から与えられるsigmas配列をサンプラーに取り込み、標準的なサンプリングループ(ノイズスケジュール制御)をより柔軟に操作できる点が肝です。これにより既存のスケジューラに依存しないカスタムノイズスケジュールや外部ツールで生成したスケジュールを取り込む運用が可能になります。外部sigmasサポートは、異なるタイムステップ解像度や非線形スケジューリングを試す際に有用です。

次にPainterLTXVtoVideoは、入力となる潜在表現(latent)を音声トラックと映像トラックに論理的に分離・整列し、動画生成に適した形へ変換する前処理ノードです。LTXVワークフローでは、音声情報(例えば時間軸に沿った条件付けや特徴量)と映像用latentを別個に扱う必要があるため、潜空間のサイズ・次元合わせ、タイムステップの同期、シードやバッチ処理の統一などが重要になります。本リポジトリのノードはこれらの前処理を自動化し、後段のサンプラーやデコーダへシームレスに渡すことを目指しています。

構造面では、nodes.pyにノード定義が集約され、init.pyでComfyUIへの登録(ノード名、入力・出力ポート、メタ情報)を行うのが一般的なパターンと推測されます。workflow.jsonはサンプルワークフローを示し、実際にどの順序でノードを置けば良いかを即座に検証できます。実運用ではGPUメモリ管理(fp16の利用やバッチ分割)、乱数シードの固定と可視化、外部sigmasのフォーマット(配列長、正規化)に注意が必要です。拡張性としては、既存のサンプラーやスケジューラとの互換性を保ちながら、シグマインジェクションを行うためのラッパー的実装が想定され、他のComfyUIノードやカスタムデコーダとの組み合わせで専門的な映像生成パイプラインを構築できます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • README.md: file
  • init.py: file
  • nodes.py: file
  • workflow.json: file

まとめ

LTXVに特化した実装で、映像生成ワークフローを整理する実用的なComfyUI拡張です。

リポジトリ情報:

READMEの抜粋:

ComfyUI-PainterLTXV2

此节点由绘画小子制作

Advanced LTXV Sampling & Latent Preparation for ComfyUI

ComfyUI custom nodes providing LTXV audio-video separation sampling and latent preparation capabilities for professional video generation workflows.

PainterLTXV2:ComfyUI 的 LTXV 高级采样与潜空间准备节点,图生文生一体,效果和官方一致,让工作流简洁明了

为专业视频生成工作流提供 LTXV 音视频分离采样和潜空间准备功能的 ComfyUI 自定义节点。