LibreAI / AI 3D / img2threejs
// ai-3d · img2threejs/img2threejs

img2threejs

Turn a reference image into a procedural, animation-ready Three.js model - as code

★ 17.7k stars⑂ 1.5k forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

img2threejs is an open-source ai 3d project by img2threejs (img2threejs/img2threejs on GitHub). It has 17,720 GitHub stars and 1,486 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
17,720
Forks
1,486
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
AI 3D
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Pick a reference image

    Choose a clear image of the single object you want rebuilt in 3D.

  2. Install the skill

    Run the npx installer to add the base skill to your agent; add plugin harnesses only if you need them.

  3. Verify the install

    Run the doctor command to confirm the setup is healthy.

  4. Run your first reconstruction

    Ask your agent to rebuild the image and review the generated Three.js scene.

// features

Why people love it

Procedural code models

The output is readable Three.js code you can edit, animate and version - not a baked mesh.

Quality-gated output

Reconstructions pass through quality gates before being accepted.

Token-efficient

Designed to minimize the agent tokens needed per reconstruction (the README explains the approach).

Agent skill format

Installs as a skill your existing agent uses; a legacy skill can also be cloned straight into a skills folder.

Plugin harness

Optional plugins extend capability - the README advises installing only what you need.

GLB reference route

Optional reference-fidelity tooling and a GLB-baseline character pipeline are available for harder subjects.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/img2threejs/img2threejs.git
    cd img2threejs
  2. Install the base skill

    The installer sets up the skill; the doctor command verifies it.

    npx --yes img2threejs@latest install
    npx --yes img2threejs@latest doctor
  3. Preview before installing

    A dry run shows exactly what the installer would change.

    npx --yes img2threejs@latest install --dry-run
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by the img2threejs project on GitHub.

Is it free to use?

Yes - img2threejs is Apache-2.0 licensed and free to use.

Does it need a paid API key?

The tooling is free, but the reconstruction is performed by your AI agent, so you need an agent setup (for example Claude Code) with its own model access.

How does it compare to alternatives?

Compared with neural image-to-3D services, img2threejs outputs procedural, editable Three.js code optimized for web use and animation, rather than a static mesh file.

How do I get started?

Run the npx installer, verify with the doctor command, and ask your agent to reconstruct a simple object first.

// keep exploring

Similar tools

AI 3D

three.ws

Turn text or a photo into a living 3D avatar with an LLM brain and wallet.

★ 221 starsApache-2.0
View guide →
AI 3D

openreality

Turn phone video into 3D scenes your AI agent can query.

★ 214 starsBSD-2-Clause
View guide →
AI 3D

Shap-E

Shap-E — OpenAI's text-to-3D and image-to-3D model: generate 3D objects as implicit functions and render them as NeRFs or textured meshes, MIT

★ 12.3k starsMIT
View guide →
AI 3D

Nerfstudio

Nerfstudio — the plug-and-play studio for NeRFs and Gaussian splatting: turn photos of a real scene into explorable 3D, with a modular API and viewer, Apache-2.0

★ 12.1k starsApache-2.0
View guide →
AI 3D

Open-DiffusionGS

Baking Gaussian Splatting into Diffusion Denoiser for Fast and Scalable Single-stage Image-to-3D Generation and Reconstruction (ICCV 2025)

★ 865 starsMIT
View guide →
AI 3D

ComfyUI-TD

Stream ComfyUI output live into TouchDesigner.

★ 167 starsAGPL-3.0
View guide →
// alternatives

Alternatives in AI 3D

The most-starred other AI 3D projects in the LibreAI catalogue — the realistic shortlist if img2threejs is not the right fit.

Get img2threejs

Free and open — grab the source, star the repo, and start creating.