img2threejs reconstructs a 3D object from a single reference image as a procedural Three.js model using code-only, token-efficient, staged pipeline with quality gates, producing animation-ready Three.js groups.

Stars

7,414

7-day growth

No data

Forks

564

Open issues

18

License

Apache-2.0

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It uniquely combines detail-first analysis, strict quality gates, and deterministic scripts to achieve token-efficient 3D reconstruction from a single image, avoiding heavy dependencies and mesh extraction.

Who it is for

  • developers building interactive 3D web experiences
  • AI/agent developers using Claude Code or similar coding agents
  • game developers needing procedural 3D assets from reference images
  • 3D artists and designers who want quick procedural models from photos

Use cases

  • generating animation-ready 3D models for web games and demos
  • creating procedural replicas of real-world objects for interactive portfolios
  • rapid prototyping of hard-surface objects from images for visualization
  • educational demonstrations of 3D reconstruction via code

Strengths

  • Token-efficient: uses deterministic scripts for validation, gating, and image processing, reserving model tokens only for visual judgment and code generation
  • Zero dependencies: pure Python 3.10+ standard library, no pip install needed
  • Strict quality gates: detail inventory and strict-quality validation prevent underspecified models before code generation
  • Animation-ready output: exposes runtime hierarchy with pivots, sockets, colliders via userData.sculptRuntime

Considerations

  • Single image cannot reveal hidden geometry; output is approximate or low-poly for unseen faces
  • Strongest for hard-surface objects; character reconstructions are stylized, not photorealistic
  • Requires agent environment (e.g., Claude Code) with browser rendering capabilities for side-by-side review

README quick start

Quick start

Description

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

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859
TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861