Trellis Blender

🚀 TRELLIS Blender アドオン

このアドオンは、TRELLIS の 3D 生成機能を Blender に統合します。TRELLIS は、SOTA のテキストから 3D および画像から 3D の AIGC モデルです。

🚀 クイックスタート

このアドオンを使用することで、Blender 内で TRELLIS の 3D 生成能力を活用できます。以下に、基本的な使い方を説明します。

✨ 主な機能

• テキストから 3D：テキストを入力すると、テクスチャ付きの 3D メッシュが生成されます。
• 画像から 3D：画像を入力すると、テクスチャ付きの 3D メッシュが生成されます。
• テキスト条件付き詳細変形：テキストと 3D メッシュを入力すると、テクスチャ付きの 3D メッシュが生成されます。
• 画像条件付き詳細変形：画像と 3D メッシュを入力すると、テクスチャ付きの 3D メッシュが生成されます。
• MCP 統合：MCP と統合されており、Cursor/Windsurf と通信することができます。詳細は Trellis MCP を参照してください。

📦 インストール

前提条件

• Blender 3.6.0 以上
• TRELLIS API サーバーを実行する（私の TreLLIS フォーク を参照）

アドオンの有効化

1. アドオンファイルをダウンロードします（このリポジトリをクローン）
2. Blender で、「編集」>「設定」>「アドオン」に移動します。
3. 「インストール」をクリックし、trellis_for_blender.py ファイルを選択します。
4. 「3D ビュー：TRELLIS」の横のチェックボックスをオンにして、アドオンを有効にします。

標準的なワークフロー

1. パネルを開きます（3D ビューを開き、n キーを押してサイドバーを開き、TRELLIS を見つけます）。
2. （オプション）シーン内のオブジェクトを選択し、条件入力として使用する画像を選択します。
3. 生成パラメータを調整します（経験上、少ないステップ数でも十分です）。
4. アドオンは選択したオブジェクトと画像/テキストを API バックエンドにアップロードします。
5. 処理が完了すると、生成されたモデルをダウンロードしてシーンにインポートできます。

メインパネルで過去のリクエストを確認できます。

MCP ワークフロー

1. パネルを開きます（3D ビューを開き、n キーを押してサイドバーを開き、TRELLIS を見つけ、「MCP サーバーを起動」をクリックします）。
2. Claude/Cursor/Windsurf を開き、以下の設定を貼り付けます。

"mcpServers": {
        "trellis": {
            "command": "uvx",
            "args": [
                "trellis-mcp"
            ]
        }
    }

📚 ドキュメント

生成パラメータ

機能

• 非同期リクエスト処理
• リアルタイムの状態更新
• エラー処理
  • "ファイルが選択されていません"：入力画像を選択してください。
  • "API 接続エラー"：API サーバーが実行中かどうかを確認してください。
  • "処理エラー"：API サーバーのログを確認して詳細を取得してください。

何か問題や議論、貢献があれば、大歓迎です！