visualbruno/ComfyUI-Trellis2

ComfyUI Wrapper for Microsoft Trellis.2 - Native and Compact Structured Latents for 3D Generation

📦 ComfyUI-Trellis2 とは？

Microsoftの TRELLIS.2 3D生成パイプラインを、拡散モデル用のビジュアルノードベースUIである ComfyUI に導入する、コミュニティ管理の カスタムノードパック です。1枚または複数の画像から、テクスチャ付き3Dメッシュ、マルチビューレンダリング、ボクセルベースの再構成を生成するエンドツーエンドのワークフローを、使い慣れたComfyUIキャンバス内で構築できます。

✨ 主な機能（変更履歴より）

マルチビュー生成 – Sparse MultiView Generator、ImageCond MultiView Generator、Shape Cascade MultiView Generator などのノードにより、複数の視点から一貫したジオメトリを作成します。
メッシュのテクスチャリングとリファインメント – Mesh Texturing Multi-View、Mesh Texturing Pixal3D MultiView、Mesh With Voxel Multi-View Generator により、UVマッピングされたテクスチャの追加、Pixal3D-Tモデルのサポート、ボクセルベースの詳細処理が可能です。
ジオメトリ処理 – リメッシュ、スムージング (PyMeshlab, Trimesh)、穴埋め (Meshlib, CuMesh)、頂点溶接、法線スムージング、簡略化 のためのノードを提供します。
レンダリング – Render MultiView (Nvdiffrast) と Preview 3D により、ComfyUI内で直接結果を可視化できます。
高度なサンプラー – 拡散ステップ用の実験的なHeun、RK4、RK5サンプラー。
外部モデルのサポート – Facebookの DINO-v3 ビジョンモデルが必要であり、オプションで TencentARC/Pixal3D-T (natten パッケージが必要) をサポートします。
プラットフォーム固有のwheel – Windows上のTorch 2.7/2.8向けに、CuMesh、nvdiffrast、nvdiffrec_render、FlexGEMM、o_voxelのプリコンパイル済みバイナリを提供します。

🛠️ インストール（クイックスタート）

前提条件
- ComfyUI（標準版またはポータブル版）をインストールします。
- HuggingFaceからDINO-v3モデルをダウンロードし、ComfyUI/models/facebook/dinov3-vitl16-pretrain-lvd1689m に配置します。
- (オプション) Pixal3D-Tサポートが必要な場合は、GitHubリポジトリから natten パッケージをインストールします。
提供されているwheelのインストール – お使いのTorchバージョン（2.7.0または2.8.0）に一致するフォルダを選択し、READMEに記載されている pip install …/*.whl コマンドを実行します。通常のPythonインストールと ComfyUIポータブル バンドルではコマンドが異なります。

Python依存関係のインストール

pip install -r ComfyUI/custom_nodes/ComfyUI-Trellis2/requirements.txt

カスタムビルド（オプション） – 作者がパッチを当てた o_voxel、CuMesh、または FlexGEMM のバージョンが必要な場合は、リンク先のレポジトリをクローンしてインストールしてください。
ComfyUIを再起動すると、新しいTrellis2ノードが Trellis2 カテゴリに表示されます。

🚀 使用方法

「PreProcess Image」ノードを追加（オプションで rembg を使用して remove_background を実行）。
画像をMulti-View Generatorに入力 – 必要なスタイル（Sparse、ImageCond、Shapeなど）を選択します。
オプションで「Mesh With Voxel … Generator」を実行 – ボクセル表現を作成し、Voxel to Mesh ノードでメッシュに変換します。
ジオメトリのリファイン – Smooth Mesh、Fill Holes With Meshlib、Weld Vertices、または Simplify Trimesh を使用します。
メッシュのテクスチャリング – Mesh Texturing Multi-View（または高品質なテクスチャマップ用のPixal3D専用ノード）を使用します。
レンダリング – Render MultiView (Nvdiffrast) で結果をレンダリングするか、Preview 3D でライブ表示します。
エクスポート – Export Mesh ノードを使用します。出力はプレビューノードと互換性があり、標準的な3D形式で保存可能です。

リポジトリには、Projection_Blender_Qwen_XViews、Projection MultiView Texturing、Pixal3Dパイプラインなどの一般的なタスク用のComfyUIグラフを含む example_workflows フォルダがあります。

📚 ヘルプの探し方

Discordコミュニティ（謝辞にリンクあり） – アクティブなユーザーがワークフローのヒントやバグ修正を共有しています。
「Blackwell Fix」 – READMEで言及されている既知の問題に対するコミュニティパッチ。
作者のTrellis.2、CuMesh、FlexGEMMのフォークには、追加のドキュメントと最新のバグ修正が含まれています。

🔗 関連プロジェクト

Microsoft/TRELLIS.2 – マルチビュー拡散ベースの3D生成を実行するオリジナルの研究コード。
ComfyUI – このラッパーがプラグインするノードベースのUI。
Pixal3D – 一部のノードで使用される高品質な3Dモデルデータセット。

ComfyUI-Trellis2 は、Microsoftの最先端3D拡散パイプラインを、ビジュアルワークフローを好むアーティストや開発者が利用できるようにするブリッジです。必要なコンパイル済み拡張機能がバンドルされており、豊富なジオメトリ処理ノードとサンプルグラフが提供されているため、数分でテクスチャ付きメッシュの生成を開始できます。