Skip to content

BLTC-520/snaproom

 
 

Repository files navigation

snaproom-1

snaproom

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/adityaavr/Snaproom
  2. Enter the directory with cd snaproom
  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 snaproom 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 snaproom 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

SNAPROOM 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. SNAPROOM 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? SNAPROOM it.
  • Your childhood bedroom? SNAPROOM it.
  • Need an environment for a robot? SNAPROOM it.
  • A film location scout? SNAPROOM it.
  • An architectural rendering? SNAPROOM it.

Development

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

snaproom

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages