Photo to 3D Model
Two-step pipeline that converts any photo into a 3D model:
- Gemini preprocess — Transform photo into a clean white-background 45° isometric view
- Tripo3D generate — Convert the isometric image into a .glb 3D model
Requirements
GEMINI_API_KEY— Get from https://aistudio.google.com/apikeyTRIPO_API_KEY— Get from https://platform.tripo3d.ai/
Usage
# Full pipeline: photo → isometric view → 3D model
python3 scripts/photo_to_3d.py <image_path>
# Custom prompt for Gemini preprocessing
python3 scripts/photo_to_3d.py <image_path> --prompt "your custom prompt"
# Skip preprocessing (image is already a clean isometric view)
python3 scripts/photo_to_3d.py <image_path> --skip-preprocess
# Custom output directory
python3 scripts/photo_to_3d.py <image_path> --output-dir ./my_output
Output
output/{name}_isometric.png— Gemini-generated isometric viewoutput/{name}_model.glb— Final 3D model file
Default Gemini Prompt
The built-in prompt generates a 45° isometric "3D-printed model" style render with PBR materials on a pure white background. Override with --prompt for custom styles (e.g., game assets, architectural models, product renders).
Notes
- Supported input: .jpg, .jpeg, .png, .webp
- Tripo3D generation takes ~1-3 minutes depending on complexity
- For higher quality, preprocess source images with upscayl before running
- Output .glb files can be converted to .usdz for Apple AR using
usdzconvert
