image-blaster README

The project's README from github.com/neilsonnn/image-blaster. As one markdown file: README.md.

image-blaster-1

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:

3D model creation supports these Hunyuan parameters:

Examples

Development

image-blaster (neilsonnn/image-blaster)

Searching Database…

这是什么?image-blaster 是一套面向 Claude 的技能集,它通过调度 Claude 技能,并结合 World Labs 和 FAL 的 API,把单张图片转换成带有网格模型和音效的 3D 环境。
这是 Claude 技能还是独立应用?主要是一个 Claude 技能:你把图片交给 Claude,它会调用外部 API 来构建 3D 场景。项目还附带了一个 React 查看器应用(位于 /app 目录),方便你预览和调整生成的结果。
我该怎么让它运行起来?克隆仓库,然后使用随附的脚本运行查看器:'bun --cwd=app run dev' 会在本地启动它,'bun --cwd=app run build' 则生成生产构建版本;技能本身则通过 Claude 调用。
使用 World Labs 和 FAL 需要 API 密钥吗?需要。image-blaster 会调用 World Labs 和 FAL 服务(也可以选用混元的 3D API)来生成网格和环境,因此使用前需要具备这些 API 的访问权限。
我能控制输出的网格质量和风格吗?可以,通过参数控制:--enable-pbr 用于开启或关闭 PBR 材质(默认开启),--generate-type 可选择 Normal、LowPoly 或 Geometry-only 输出,--polygon-type 则为 LowPoly 设置三角形或四边形面。默认目标面数为 50000,远低于混元 API 的默认值 500000。
什么类型的图片效果最好?该项目定位于电子游戏关卡概念设计、童年卧室、机器人环境、电影外景勘景和建筑效果图,本质上,任何你想转换成可探索 3D 空间的单张参考图都适用。
我能自定义查看器应用吗?可以。从 .claudeignore 文件中删除 /app 条目后,Claude 就获得了直接编辑随附 React 查看器的权限。
为什么文中会同时提到 Hunyuan、World Labs 和 FAL?Hunyuan 的 API 似乎被用作网格生成的后端(或与之配合使用)。文中提到其默认目标面数为 500000,远高于 image-blaster 自身的默认值 50000。
Creator
neilsonnn
Size
19.5 MB
Stars
11.4K
Updated
CommitMay 15
Age
5mo
Commits · 90 Days