neilsonnn/image-blaster

Source: https://github.com/neilsonnn/image-blaster

image-blaster

Creates 3D environments, SFX, and meshes from a single image using Claude skills, World Labs, and FAL.

Can take you from an image to a fully meshed 3D environment in < 5 minutes, great for jumpstarting 3D work. Go full blast.

Quickstart

1. Open a Terminal, enter git clone https://github.com/neilsonnn/image-blaster
2. Enter the directory with cd image-blaster
3. Run claude (install with curl -fsSL https://claude.ai/install.sh | bash)
4. Say hello to Claude, and give them your API key for World Labs and FAL.
5. Put an image into input/ directory and ask Claude to blast it and confirm each step with me.

Description

By default image-blaster will use your input image to create:

1. 3D models (.glb, .obj) of all dynamic objects
2. Gaussian splat (.spz) of the static environment,
3. Ambient looping sound and object specific physics SFX (.mp3)

Extensions

You can embed image-blaster under the assets of any game engine, DCC software, or web app.

1. Unity, Unreal, or Godot game engine
2. Blender, 3DS Max, or Maya or other DCC software
3. Three.js web app or Electron app

Advanced

IMAGE-BLASTER uses a few generation models:

• marble-1.1 - World Labs Marble model creates the explorable environment.
• nano-banana - default image edit preference for source cleanup, clean plates, and object reference images.
• gpt-image-2 - alternate image edit provider when the edit skill is asked to prefer it.
• hunyuan-3d - Hunyuan 3D model creates 3D object models through FAL.
• elevenlabs-sfx - ElevenLabs sound effects model creates ambient and object-specific sounds.

3D model creation supports these Hunyuan parameters:

• --face-count <40000-1500000>: target face count. IMAGE-BLASTER defaults to 50000; Hunyuan’s API default is 500000.
• --enable-pbr true|false: enable PBR material generation. Defaults to true.
• --generate-type Normal|LowPoly|Geometry: Normal creates a textured model, LowPoly applies polygon reduction, and Geometry creates a white geometry-only model. Defaults to Normal.
• --polygon-type triangle|quadrilateral: polygon type for LowPoly. Defaults to triangle.

Examples

• Video game level concepts? IMAGE-BLAST it.
• Your childhood bedroom? IMAGE-BLAST it.
• Need an environment for a robot? IMAGE-BLAST it.
• A film location scout? IMAGE-BLAST it.
• An architectural rendering? IMAGE-BLAST it.

Development

• remove /app from the .claudeignore file to give Claude the ability to change the React viewer.