img2threejs : analyse pratique fondée sur le README
img2threejs/img2threejs offre une implémentation open source exploitable en conditions réelles avec une structure réutilisable.
En bref
- De quoi s’agit-il ?
- Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.
- À qui s’adresse-t-il ?
- Ce projet convient aux lecteurs dont le besoin correspond précisément aux fonctions documentées de img2threejs. Avant adoption, vérifiez le chemin propre au dépôt : commande d exemple, fichier de configuration, version publiée et résultat observé.
- Puis-je l’utiliser commercialement ?
- Oui. Apache-2.0 est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 2 jours.
- En quel langage est-il écrit ?
- Principalement Python, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Un chemin purement codé de l'image à Three.js
img2threejs prend une seule image de référence d'un objet et produit une fabrique TypeScript qui retourne un THREE.Group. Ce groupe est construit entièrement à partir de primitives, de shaders procéduraux et de géométrie générée ; aucun fichier de maillage n'est importé et aucun pack d'art téléchargé n'est utilisé. La sortie porte une hiérarchie d'exécution avec pivots, sockets et colliders, donc le modèle est prêt à animer plutôt que d'être une forme statique. Le pipeline s'exécute sous Claude Code, Codex ou OpenCode, et utilise toute capacité de lecture d'image fournie par l'hôte, qu'il s'agisse de lecture d'image native, d'un MCP navigateur, de l'aperçu du projet ou d'une capture d'écran fournie par l'utilisateur.
Une boucle de sculpture par étapes avec des portes déterministes
Le pipeline suit huit étapes dans l'ordre : blockout, structure, forme, matériau, surface, éclairage, interaction et optimisation. Après chaque passage, le rendu généré est comparé à l'image de référence, et le système s'auto-corrige jusqu'à ce que chaque caractéristique définissant l'identité dépasse son seuil. Des scripts Python déterministes gèrent la validation et les portes, tandis que les tokens de modèle sont réservés au jugement visuel et à la génération de code. Cette séparation maintient le processus efficace en tokens, et l'architecture complète, y compris le diagramme de pipeline et la référence de script, est documentée dans docs/ARCHITECTURE.md.
Inventaire de détails et portes de revue spécifiques au sujet
Avant toute génération de code, le pipeline classe le sujet comme objet, personnage ou hybride. Les objets suivent le pipeline de surface dure ; les personnages passent par une piste sensible à l'anatomie documentée dans grimoire/character/reconstruction.md. Une analyse prioritaire aux détails construit un detailInventory des petits détails définissant l'identité tels que brillance, biseaux, vis, lignes et usure. Chaque détail doit correspondre à un composant ou une entrée de matériau réel, et une porte de qualité stricte bloque la génération jusqu'à ce que l'inventaire soit complet. Pour les armes CS2, des contrats de composants spécifiques à la famille imposent une couverture explicite, et les portes de revue empêchent une texture convaincante de remplacer une géométrie réelle.
Démarrage rapide : cloner, invoquer et générer
Installez le skill en clonant le dépôt dans votre répertoire de skills, par exemple git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs. Dans Claude Code, attachez une image d'objet et exécutez /img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours. Le skill classe le sujet, exécute l'inventaire de détails et contrôle chaque passage. Pour plus de contrôle, vous pouvez exécuter les scripts déterministes directement depuis la racine du skill avec Python 3.10+ : probe_image.py, new_pre_spec_assessment.py, new_sculpt_spec.py, validate_sculpt_spec.py avec --strict-quality, et generate_threejs_factory.py. Le README montre les lignes de commande exactes pour chaque étape.
Versions publiées et feuille de route
Le projet a publié v1.0 avec le pipeline objet, v1.1 ajoutant l'analyse prioritaire aux détails, v1.2 ajoutant un générateur de personnage humanoïde, v1.3 ajoutant le harnais de revue Divine Eye et les mathématiques de couleur CIEDE2000, v1.4 la mise à jour d'armes pour la reconstruction assortie à l'image CS2, et v1.4.1 durcissant le chemin CS2. Un générateur de créatures avec quatre plans de corps a également été publié. La feuille de route continue avec v1.5 Mise à jour de personnages, v1.6 Mise à jour d'environnement, v1.7 Mise à jour de pipeline de jeu avec exportateurs Unity et Unreal, v1.8 Mise à jour d'animation, v1.9 Mise à jour de studio IA, et v2.0 Mise à jour de monde procédural. La feuille de route complète se trouve dans ROADMAP.md.
Limites honnêtes et licence Apache 2.0
Le README déclare clairement qu'une seule image ne peut pas révéler les côtés cachés ni garantir une géométrie exacte. La sortie peut être approximative, stylisée ou low-poly, et les faces invisibles sont déduites en miroir des faces visibles plutôt que faussées. Le skill rapporte la confiance par région et peut retourner 'Cette image ne peut pas atteindre la fidélité demandée' comme résultat valide. Les personnages sont des reconstructions stylisées, pas des ressemblances photoréalistes. Le projet est sous licence Apache License 2.0, qui accorde une licence de droit d'auteur perpétuelle, mondiale, non exclusive, gratuite, sans redevance et irrévocable pour reproduire, préparer des œuvres dérivées et distribuer. Le texte de licence ne mentionne aucune garantie, support ou garanties de sécurité.
Conclusion éditoriale
Ce projet convient aux lecteurs dont le besoin correspond précisément aux fonctions documentées de img2threejs. Avant adoption, vérifiez le chemin propre au dépôt : commande d exemple, fichier de configuration, version publiée et résultat observé. Les performances et garanties absentes du README restent à établir dans votre contexte.
Notes de la communauté