jjohnson5253/brickbuilderai

Analysis updated 2026-05-18

★ 10PythonAudience · vibe coderComplexity · 4/5LicenseSetup · moderate

Mindmap

mindmap
  root((BrickBuilder))
    Input
      Upload image
      Text prompt
    Pipeline
      AI 3D reconstruction
      Voxelization
      Brick optimization
    Output
      3D browser viewer
      Building instructions
      LDR MPD download
    Tech
      Python FastAPI
      React Three.js
      RunPod SAM-3D

mindmap root((BrickBuilder)) Input Upload image Text prompt Pipeline AI 3D reconstruction Voxelization Brick optimization Output 3D browser viewer Building instructions LDR MPD download Tech Python FastAPI React Three.js RunPod SAM-3D

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Convert a photo of any object into a LEGO brick model with step-by-step building instructions

USE CASE 2

Type a description of what you want to build and get a 3D LEGO model to view and download

USE CASE 3

Download the LDR/MPD file from a generated model to open in BrickLink Studio or other LEGO design tools

USE CASE 4

Study how the pipeline connects image-to-3D AI, voxelization, and brick optimization as a full-stack example

What is it built with?

PythonTypeScriptReactFastAPIThree.jsDocker

How does it compare?

	jjohnson5253/brickbuilderai	alsgur9865-sketch/second-brain-engine	compumaxx/gba-video-studio
Stars	10	10	10
Language	Python	Python	Python
Setup difficulty	moderate	moderate	hard
Complexity	4/5	3/5	4/5
Audience	vibe coder	developer	developer

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a fal.ai API key, high-quality SAM-3D mode needs a RunPod GPU endpoint (H100 recommended) with the published Docker image jjohnson5253/manifold-sam3d.

Use freely for any purpose including commercial use as long as you keep the copyright notice.

In plain English

BrickBuilder is a web app that turns a photo or text description into a buildable LEGO-compatible brick model. You upload an image or type what you want, and within about 30 seconds you get a 3D brick model you can rotate in the browser, view step-by-step building instructions for, download as an LDR or MPD file that works with LEGO digital design tools, or use as a parts list to order physical bricks. The process goes through several steps. An AI model first reconstructs a 3D shape from the input. Two options are available: Trellis for simpler use, and SAM-3D for better quality (SAM-3D requires a separate GPU-powered worker hosted on RunPod). The 3D shape is then broken down into voxels (a 3D grid of cubes), and an optimizer converts those voxels into real LEGO-compatible bricks that fit together correctly. The project is split into three parts: a React and TypeScript frontend with a 3D viewer built on Three.js, a Python FastAPI backend that handles image processing and brick optimization, and an optional serverless worker for the SAM-3D pipeline running on a cloud GPU. Optional integrations include Supabase for storage and Stripe for payments, but both are optional: a local PostgreSQL database runs automatically if Supabase is not configured. To run it locally you need Python 3.10 or later, Node.js, the uv Python package manager, and a free API key from fal.ai. Two commands handle installation and startup. The higher-quality SAM-3D path requires deploying a public Docker container to RunPod with a GPU. The project is MIT-licensed and includes a note that LEGO is a trademark of the LEGO Group, which does not endorse this project.

Copy-paste prompts

Prompt 1

I uploaded an image to BrickBuilder and got a 3D LEGO model. How does the voxelization step work and how does the brick optimizer turn voxels into real LEGO-compatible parts?

Prompt 2

I want to run BrickBuilder locally with the high-quality SAM-3D mode. Walk me through deploying the RunPod Docker worker and connecting it to the FastAPI backend via env variables.

Prompt 3

Show me how BrickBuilder's Three.js frontend renders the brick model and how the step-by-step building instructions are generated from the optimizer output.

Prompt 4

I want to swap in a different image-to-3D model instead of Trellis or SAM-3D. How is the backend pipeline structured and where would I integrate it?

Frequently asked questions

What is brickbuilderai?

A web app that converts any photo or text description into a buildable LEGO-compatible brick model, with a 3D viewer, building instructions, and downloadable files.

What language is brickbuilderai written in?

Mainly Python. The stack also includes Python, TypeScript, React.

What license does brickbuilderai use?

Use freely for any purpose including commercial use as long as you keep the copyright notice.

How hard is brickbuilderai to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is brickbuilderai for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub jjohnson5253 on gitmyhub

Verify against the repo before relying on details.