img2threejs/img2threejs

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

解決する課題

img2threejsは、オブジェクトやキャラクターの単一の参照画像を、プロシージャルなThree.jsモデルに変換します。フォトグラメトリやメッシュ抽出とは異なり、コードのみのジオメトリ、プリミティブ、およびプロシージャルシェーダーを使用してオブジェクトを再構築するため、結果はアニメーションに即時利用可能であり、AIエージェントにとってトークン効率に優れたものになります。

仕組み

このプロジェクトは、AIエージェント（Claude Codeなど）と決定論的なPythonスクリプトを統合した、段階的な彫刻パイプラインを使用しています。プロセスは、厳格なビルドパスのシーケンスに従います：

Analysis: システムが対象（オブジェクト、キャラクター、またはハイブリッド）を分類し、アイデンティティを定義する特徴（ベベル、ネジ、光沢など）の detailInventory を作成します。
Specification: コンポーネントツリーとマテリアルを定義する ObjectSculptSpec JSONを作成します。
Iterative Sculpting: モデルは、複数のパス（ブロックアウト $ ightarrow$ 構造 $ ightarrow$ 形状の洗練 $ ightarrow$ マテリアル $ ightarrow$ サーフェス $ ightarrow$ ライティング $ ightarrow$ インタラクション $ ightarrow$ 最適化）で構築されます。
Review Loop: 各パスの後、Pythonスクリプトが並列比較シート（参照 vs レンダリング）を生成します。AIエージェントがレンダリングを確認し、ビジョンスコアに基づいて continue、refine-spec、または refine-code を決定します。
Output: 最終的な結果は、アニメーション用の実行時階層（ピボット、ソケット、コライダー）を持つ THREE.Group を返すTypeScriptのファクトリ関数です。

対象者

重いメッシュファイルや手動モデリングに頼らずに画像から3Dアセットを生成したい開発者やテクニカルアーティスト、特にAIエージェントを使用して3D作成ワークフローを自動化しようとしている方に適しています。

ハイライト

Code-only Reconstruction: バイナリメッシュファイルの代わりにTypeScriptコードを生成するため、アセットの差分比較（diff）やバージョン管理が可能です。
Agent-Agnostic: ビジョン機能とブラウザツールを持つあらゆるエージェント（例：Claude Code, Codex）で使用可能です。
Token-Efficient: 機械的なタスク（検証、PBR抽出、比較パッケージング）をPythonスクリプトにオフロードすることで、モデルのトークンを節約します。
Animation-Ready: 静的なメッシュを生成するのではなく、ピボットやソケットを含む実行時階層を含みます。
Strict Quality Gates: 仕様がオブジェクトの複雑さに一致するほど詳細になるまで、コード生成を防止します。