whatisgithub

What is three.js-object-sculptor-codex-plugin?

vinhhien112/three.js-object-sculptor-codex-plugin — explained in plain English

Analysis updated 2026-05-18

1,426PythonAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A Codex plugin that turns a photo of an object into a code-only, animation-ready 3D model built with Three.js.

Mindmap

mindmap
  root((Object Sculptor))
    What it does
      Builds 3D model from image
      Guides step by step sculpting
      Checks render against photo
    Tech stack
      Python
      Three.js
      Codex
    Use cases
      Game props and props
      Animation ready objects
    Audience
      Game developers
      3D web developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a reference photo of an object into a procedural Three.js model built with code.

USE CASE 2

Build animation-ready game props with pivots and attachment points already in place.

USE CASE 3

Recreate objects like trees, ships, or mechanical parts without downloading external art assets.

USE CASE 4

Generate a structured spec of an object's parts and materials before writing any 3D code.

What is it built with?

PythonThree.jsCodex

How does it compare?

vinhhien112/three.js-object-sculptor-codex-pluginanthropics/jacobian-lenslittledivy/mimic
Stars1,4261,4341,445
LanguagePythonPythonPython
Last pushed2026-07-17
MaintenanceActive
Setup difficultymoderatemoderatemoderate
Complexity4/54/53/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Codex with local plugin support, Python 3.10+, and a Three.js project to use the generated code.

No license information was found in the README.

So what is it?

Three.js Object Sculptor is a plugin for Codex, an AI coding assistant, that turns a picture of an object into a 3D model built entirely out of code, using a JavaScript library called Three.js that renders 3D graphics in a web browser. Instead of scanning the object or downloading a ready made 3D asset, it guides the AI through a step by step process: check that the image is usable, describe the object in detail, break it down into its shapes and materials, build it from a rough blockout up to fine detail, connect the parts so they can be animated later, then compare a render of the result against the original photo. The plugin is meant for objects that will move or interact in a scene, such as game props, mechanical parts, destructible objects, or even plants and trees, rather than for exact scans. The README is upfront that it is not meant for photogrammetry or for pulling a perfect mesh out of a single photo. Its output is a structured plan called an ObjectSculptSpec that records the object's parts, materials, lighting, and the pivot points needed for later animation, followed by generated code that builds the 3D model. The project includes checks meant to catch a common failure in AI generated 3D models, where the overall shape looks right but small identifying details are missing or wrong. It compares a screenshot of the rendered model to the original reference image using an AI vision reviewer and can block progress if an important feature does not match closely enough. To use it, someone needs Codex with local plugin support and Python 3.10 or newer installed, and it is set up by cloning the plugin into a local plugins folder and registering it in a Codex marketplace configuration file. The helper scripts rely on Python's standard library and do not need a full browser automation tool installed. Two live demos, a tower ship and an autumn tree, show the kind of output the plugin can produce.

Copy-paste prompts

Prompt 1
Install the Three.js Object Sculptor plugin in Codex and describe the setup steps.
Prompt 2
Use this plugin to turn my attached image of a robot into a procedural Three.js model.
Prompt 3
Explain how the ObjectSculptSpec captures an object's geometry and materials in this project.
Prompt 4
Walk me through comparing the rendered model against my reference image using this plugin.

Frequently asked questions

What is three.js-object-sculptor-codex-plugin?

A Codex plugin that turns a photo of an object into a code-only, animation-ready 3D model built with Three.js.

What language is three.js-object-sculptor-codex-plugin written in?

Mainly Python. The stack also includes Python, Three.js, Codex.

What license does three.js-object-sculptor-codex-plugin use?

No license information was found in the README.

How hard is three.js-object-sculptor-codex-plugin to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is three.js-object-sculptor-codex-plugin for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.