Turn a source image (or multi-color mask image) into a 3D-printable bas-relief STL by mapping colors (or grayscale) to heights. Use when you have an image from an image-gen skill (nano-banana-pro, etc.) and want a real, printable model (STL) via a deterministic pipeline.
Generate a watertight, printable STL from an input image by mapping colors (or grayscale) to heights.
This is an orchestrator-friendly workflow:
Ask the image model for:
That makes segmentation reliable.
bash scripts/image_to_relief.sh input.png --out out.stl \
--mode palette \
--palette '#000000=3.0,#ffffff=0.0' \
--base 1.5 \
--pixel 0.4
bash scripts/image_to_relief.sh input.png --out out.stl \
--mode grayscale \
--min-height 0.0 \
--max-height 3.0 \
--base 1.5 \
--pixel 0.4
out.stl (ASCII STL)out-preview.svg (vector preview via potrace; best-effort)--pixel parameter controls resolution (smaller = higher detail, bigger STL).