img2threejs: 単一画像からコードのみでThree.jsモデルを再構築
img2threejs/img2threejsは実運用向けに使える実用的なオープンソース実装で、再利用可能な導入ルートを持つプロジェクトです。
ひと目でわかる
- これは何？
- 参照画像内のオブジェクトを、品質ゲートとトークン効率を備えた手続き型でアニメーション対応のThree.jsモデルとして再構築するスキル。
- 誰に向いている？
- img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。
- 商用利用できる？
- できます。Apache-2.0 は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 2 日前です。
- 何の言語で書かれている？
- 主に Python です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
一枚の画像からTHREE.Groupへ
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 一枚の画像からTHREE.Groupへでは、READMEにある対象と範囲をこの節の論点として読みます。
画像からThree.jsへのコードのみのパス。img2threejsは、オブジェクトの単一の参照画像を受け取り、THREE.Groupを返すTypeScriptファクトリを生成します。そのグループは、プリミティブ、手続き型シェーダー、生成されたジオメトリのみで構築され、メッシュファイルはインポートされず、ダウンロードされたアートパックも使用されません。出力には、ピボット、ソケット、コライダーを備えたランタイム階層が含まれているため、モデルは静的シェイプではなく、アニメーション化する準備ができています。パイプラインはClaude Code、Codex、またはOpenCodeで実行され、ネイティブ画像読み取り、ブラウザMCP、プロジェクトプレビュー、ユーザー提供のスクリーンショットなど、ホストが提供するあらゆる画像読み取り機能を使用します。
導入判断ではimg2threejsのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 一枚の画像からTHREE.Groupへに関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。
8段階のゲート付き彫刻ループ
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 8段階のゲート付き彫刻ループでは、READMEにある対象と範囲をこの節の論点として読みます。
決定的ゲートを備えた段階的彫刻ループ。パイプラインは、ブロックアウト、構造、フォーム、マテリアル、サーフェス、ライティング、インタラクション、最適化の8つの段階を順に実行します。各パスの後、生成されたレンダリングは参照画像と比較され、アイデンティティを定義するすべての機能がしきい値をクリアするまでシステムは自己修正します。決定的なPythonスクリプトが検証とゲートを処理し、モデルトークンは視覚的判断とコード生成にのみ使用されます。この分離によりプロセスはトークン効率が高く、パイプライン図やスクリプトリファレンスを含む完全なアーキテクチャはdocs/ARCHITECTURE.mdに文書化されています。
導入判断ではimg2threejsのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 8段階のゲート付き彫刻ループに関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。
detailInventoryが生成を止める条件
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 detailInventoryが生成を止める条件では、READMEにある対象と範囲をこの節の論点として読みます。
詳細インベントリと主題固有のレビューゲート。コードが生成される前に、パイプラインは主題をオブジェクト、キャラクター、ハイブリッドのいずれかに分類します。オブジェクトはハードサーフェスパイプラインに従い、キャラクターはgrimoire/character/reconstruction.mdに文書化された解剖学的認識トラックを通ります。詳細優先分析は、光沢、ベベル、ネジ、ライン、摩耗などのアイデンティティを定義する小さな詳細のdetailInventoryを構築します。各詳細は実際のコンポーネントまたはマテリアルエントリにマップする必要があり、厳格な品質ゲートはインベントリが完了するまで生成をブロックします。CS2武器の場合、ファミリー固有のコンポーネント契約が明示的なカバレッジを強制し、レビューゲートは説得力のあるテクスチャが実際のジオメトリの代わりになるのを防ぎます。
導入判断ではimg2threejsのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 detailInventoryが生成を止める条件に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。
Claude Codeから実行する手順
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 Claude Codeから実行する手順では、READMEにある対象と範囲をこの節の論点として読みます。
クイックスタート: クローン、呼び出し、生成。リポジトリをスキルディレクトリにクローンしてスキルをインストールします。例: git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs。Claude Codeでオブジェクト画像を添付し、/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours. を実行します。スキルは主題を分類し、詳細インベントリを実行し、各パスをゲートします。加えて制御したい場合は、スキルルートからPython 3.10+で決定的スクリプトを直接実行できます: probe_image.py、new_pre_spec_assessment.py、new_sculpt_spec.py、validate_sculpt_spec.py（--strict-quality付き）、generate_threejs_factory.py。READMEには各ステップの正確なコマンドラインが示されています。
導入判断ではimg2threejsのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 Claude Codeから実行する手順に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。
見えない面と忠実度の限界
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 見えない面と忠実度の限界では、READMEにある対象と範囲をこの節の論点として読みます。
リリース済みバージョンとロードマップ。プロジェクトは、オブジェクトパイプラインを備えたv1.0、詳細優先分析を追加したv1.1、ヒューマノイドキャラクタージェネレーターを追加したv1.2、Divine EyeレビューハーネスとCIEDE2000カラー演算を追加したv1.3、CS2画像マッチング再構築のためのv1.4ウェポンアップデート、CS2パスを強化したv1.4.1をリリースしました。4つのボディプランを備えたクリーチャージェネレーターもリリースされています。ロードマップは、v1.5キャラクターアップデート、v1.6環境アップデート、UnityおよびUnrealエクスポーターを備えたv1.7ゲームパイプラインアップデート、v1.8アニメーションアップデート、v1.9 AIスタジオアップデート、v2.0手続き型ワールドアップデートと続きます。完全なロードマップはROADMAP.mdにあります。
導入判断ではimg2threejsのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 見えない面と忠実度の限界に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。
採用判断とプレビュー確認
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 採用判断とプレビュー確認では、READMEにある対象と範囲をこの節の論点として読みます。
誠実な制限とApache 2.0ライセンス。READMEは、単一の画像では隠れた側面を明らかにしたり、正確なジオメトリを保証したりできないことを明確に述べています。出力は近似、様式化、または低ポリゴンになる可能性があり、見えない面は偽造するのではなく、見える面をミラーリングして推測されます。スキルは領域ごとの信頼度を報告し、「この画像から要求された忠実度に到達できません」という有効な結果を返すことができます。キャラクターは様式化された再構築であり、フォトリアルな類似性ではありません。プロジェクトはApache License 2.0の下でライセンスされており、複製、派生作品の作成、配布のための永続的、世界的、非独占的、無償、ロイヤリティフリー、取消不能の著作権ライセンスを付与します。ライセンステキストには、保証、サポート、セキュリティの保証については記載されていません。
導入判断ではimg2threejsのREADMEに記載された具体的な入口を一つ選び、入力、設定、出力、エラーを同じ記録に残します。資料にない性能や安全性は補いません。img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 実行前後の差分を確認し、更新で挙動が変わった箇所だけを切り分けます。 採用判断とプレビュー確認に関してREADMEが明記していない条件は、未確認のまま採用範囲の外へ置きます。
編集部の結論
img2threejsは単一画像を入力に、プリミティブ、手続き型シェーダー、生成ジオメトリだけでThree.jsのTHREE.Groupを作るスキルです。メッシュファイルや外部アートパックに依存しない点が設計上の境界です。 向いているのはREADMEの対象環境と入力形式を管理できる利用者です。本番の保証や性能をREADMEだけで決めたい利用者には向きません。 最初に確認する対象はREADMEの導入手順と生成物、権限、失敗時のログです。
コミュニティノート