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

1,186

7-day growth

No data

Forks

95

Open issues

8

License

MIT

Last updated

2026-07-20

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.

NousResearch
Featured
NousResearch GitHub avatar

hermes-agent

Hermes Agent is an open-source, self-improving AI agent with a built-in learning loop that creates skills from experience, runs across platforms, and supports any LLM provider.

AI & Machine Learning
215,644
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.

Developer ToolsDesktop Apps
833
S40911120
Featured
S40911120 GitHub avatar

recensa

A self-hosted viewer for Claude Code session transcripts that indexes and renders every session as a readable, searchable, and auditable conversation with full-text search, diff views, and multi-agent support — all running locally on your machine with no data uploads.

AI & Machine LearningDeveloper Tools
20