visualbruno/3DGenStudio

🎨 3D Gen Studio とは何ですか？

3D Gen Studio は、テキストプロンプトからゲーム用メッシュまでを1つのビジュアルワークスペース内で構築できるオープンソースのデスクトップ/ウェブアプリです。このアプリは、ComfyUI（ノードベースのAI画像生成エンジン）と複数の外部3D生成APIを統合し、UVアンワップ、リトポロジー、リギング、テクスチャーベイキング、LODなど、一連のメッシュ編集ツールを追加しています。

コアとなるアイデアは、パイプラインUIで、カンバンボード（カードが段階を経て流れ込む）またはノードグラフ（アセットが矢印でリンクされたノード）のどちらかの形式で表示できる点です。各カードまたはノードはComfyUIワークフローまたは外部REST/GraphQL APIをトリガーでき、結果は自動的に次の段階に流れ込みます。

---

🛠️ 主な機能（READMEに記載）

機能	機能の説明
カンバンボード	カードをドラッグアンドドロップで段階（画像 → 画像編集 → メッシュ生成 → メッシュ編集 → テクスチャリング）を通過させる。各カードはカスタムメタデータを保持でき、ComfyUIワークフローまたはAPI呼び出しを起動できる。
ノードグラフビュー	アセットのビジュアルグラフ。ノードをクリックするとパラメータを編集、関連するComfyUIワークフローを実行、またはメッシュプレビューを表示できる。
アセットライブラリ	画像、メッシュ（GLB/OBJ/FBX）、ComfyUIワークフローファイルの中央集権的なビュー。バージョン管理、フォーマットバッジ、プロジェクトへのワンクリックインポートをサポート。
ComfyUI統合	任意のComfyUIワークフローをローカルで実行。パラメータはインラインで編集可能で、出力は新しいアセットとしてキャプチャされる。
外部APIサポート	任意のREST/GraphQL 3Dサービス（例：TripoSR、Wonder3D、Kimodo）をカードまたはノードから呼び出せる。
ローカルファーストストレージ	プロジェクトはディスク上（SQLite/LowDB）に保存され、Git同期可能でクラウドに縛られないポータブル性を持つ。
メッシュエディタ	アプリ内ツールで以下の操作が可能：

• テクスチャリング（テクスチャをメッシュに投影）
• ベーシックモデリング（面/頂点編集）
• スカルプティング（標準ブラシ）
• メッシュ上への直接ペイント
• ブラシ駆動のテッセレーションによるディスプレースメント
• ComfyUIを使用したテクスチャの投影
• オートUVアンワップ、オートリトポ、オートリギング（SkinTokensおよびKimodoによるAI駆動のスケルトン/ウェイト）
• 最適化/LOD生成、コリジョンハル作成
• ノーマル/AO/ポジションマップのベイキング
• ゲーム用チェック（三角形予算、UVシーム、スケール、ピボット） | | バッチプロジェクト | 自動実行される一連の段階を定義可能。画像、メッシュ、ブール型をサポートし、アセットリストのエクスポートも可能。 | | マルチユーザー / LAN | サーバーを別のマシンにホスト可能。デスクトップアプリはLANまたはリバースプロキシの背後から接続可能。 | | クロスプラットフォームデスクトップアプリ | Electron/Nodeで構築。Windows、macOS（Apple Silicon限定）、Linuxで動作。 | | 詳細な変更履歴 | 頻繁な更新（週に複数回）で、新しいジェネレータ、VFXツール、ツリー/アセンブリジェネレータ、アニメーション統合（MoCapAnythingV2、Kimodo）、UIの改善が追加されている。 |

---

🚀 一般的なワークフロー

1. 画像の作成／インポート – ComfyUIのテキストから画像モデルを使用、または外部APIを呼び出す。
2. 画像の編集 – インペイント、ノーマルマップ生成、背景除去。
3. メッシュの生成 – カードから3D生成サービス（例：TripoSR）を呼び出す。
4. UVとテクスチャ – オートUV、投影、またはテクスチャペイントのステップを実行。
5. 最終調整 – マップをベイキング、LODを作成、メッシュをリギングし、GLB/OBJ/FBXとしてエクスポート。

すべてのステップは、カンバンボード上のカードの移動またはグラフビュー内のリンクされたノードとして視覚化できる。

---

📦 インストール（要約）

• 前提条件：Node.js + npm、実行中のComfyUIインスタンス、バックエンドサーバー用のPython 3。
• リポジトリをクローン → npm install → npm run dev でフロントエンドを起動。
• python-serverフォルダ内：仮想環境を作成、pip install -r requirements.txt、その後 python main.py を実行。
• バックエンドは http://localhost:3001 で動作。Vite開発サーバーがUIを提供。
• macOS Apple-Siliconビルドには手動でのGatekeeperバイパスが必要（READMEを参照）。

---

🧩 技術スタック

• フロントエンド：React、Vite、Three.js（@react-three/fiber、@react-three/drei）。
• バックエンド：Node/Express + Multer（ファイルアップロード用）。
• ストレージ：SQLite + LowDB（アセットメタデータ用）。
• AI統合：ComfyUI（ローカル）＋任意の外部AI/3D API。

---

🤝 コミュニティと貢献

• PRを歓迎（READMEにバッジあり）。
• サポートや機能議論用のDiscordチャンネル。
• 詳細なドキュメントをアプリにバンドルしたWiki。

---

📚 まとめ

3D Gen Studio は、AI駆動の画像生成、3Dメッシュ作成、そして包括的なメッシュ編集ツールを統合した、本格的で活発にメンテナンスされているオープンソースプロジェクトです。アーティスト、ゲーム開発者、研究者向けに、クラウドサービスに縛られない1つの場所でAI生成3Dアセットをプロトタイピングできるよう設計されています。