git404hub

what is image-3d fr?

animede/image-3d — explained in plain English

Analysis updated 2026-05-18

147PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

A local web app that converts a photo into a downloadable 3D printable model, with an optional GPU based AI generator for accurate shapes.

vibe map

mindmap
  root((image-3d))
    What it does
      Image to 3D mesh
      Browser viewer
      Export STL 3MF GLB OBJ
    Tech stack
      Python
      FastAPI
      Three.js
      CUDA
    Generators
      Mock shape
      Hunyuan3D-2
      Pixal3D
    Use cases
      3D printable figures
      Multi view input
      Color texture output
    Audience
      Developers
      Hobbyist makers

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 make with this?

VIBE 1

Turn a product photo into an STL file ready for a 3D printer.

VIBE 2

Generate a printable figure from front and back photos of a character.

VIBE 3

Split a single character reference sheet image into multiple usable views automatically.

VIBE 4

Preview a generated 3D model in the browser before downloading it.

what's the stack?

PythonFastAPIThree.jsCUDA

how it stacks up fr

animede/image-3d2dogsandanerd/clawrageesjgong/graph-cad
Stars147147147
LanguagePythonPythonPython
Setup difficultyhardmoderatehard
Complexity4/54/55/5
Audiencedeveloperdeveloperresearcher

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

how do i run it?

Difficulty · hard time til it works · 1h+

Real image to 3D generation needs an NVIDIA GPU with CUDA 12.8 and 16 to 32GB of VRAM, the mock generator needs none.

License terms are not stated in the provided README excerpt.

in plain english

image-3d is a local web application that turns a photo or drawing into a 3D printable file. You upload an image, the app generates a 3D mesh from it, and you can preview the result in a browser based 3D viewer before downloading it as STL, 3MF, GLB, or OBJ, the common formats a 3D printer or slicer software expects. Right now the project ships with a mock generator by default, meaning it produces a fixed, predictable test shape rather than one that actually reflects your uploaded image. This lets the full pipeline, from upload through mesh cleanup to download, run and be tested even without a GPU. When you have an NVIDIA GPU with recent CUDA drivers, you can switch to a real image to 3D model called Hunyuan3D-2, which does generate a shape that matches the picture you provide. A third option, Pixal3D, is also supported and can add color and surface detail to the output. The project also supports feeding in multiple views of the same subject, such as front and back photos, automatically splitting a single character reference sheet into separate views, applying a four color mode for printers that support multi color output, and generating texture paint on the model surface, though that last feature needs an extra CUDA build step. Setup involves creating a Python virtual environment and installing dependencies, then starting the app with a provided script, after which it runs a small local web server you open in your browser. Configuration, such as which generator to use, the server address, and upload size limits, is controlled through environment variables. The project includes a REST API for creating generation jobs, checking their status, and fetching the resulting files, along with a test suite covering the mesh processing, the API, and the color and texture handling. Minimum GPU memory for the real generator is documented, ranging from about 16GB for basic shape generation to 32GB when texture painting is enabled. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Help me set up image-3d locally with the mock generator so I can test the pipeline without a GPU.
prompt 2
Walk me through switching image-3d to the Hunyuan3D-2 generator on my NVIDIA GPU.
prompt 3
Show me how to call the image-3d API to create a job and download the resulting STL file.
prompt 4
Explain how to enable four color print output in image-3d.

Frequently asked questions

what is image-3d fr?

A local web app that converts a photo into a downloadable 3D printable model, with an optional GPU based AI generator for accurate shapes.

What language is image-3d written in?

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

What license does image-3d use?

License terms are not stated in the provided README excerpt.

How hard is image-3d to set up?

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

Who is image-3d for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.