neilsonnn/image-blaster

image-blaster

利用 Claude 技能、World Labs 和 FAL，从单张图像创建 3D 环境、音效和网格模型。

可在 5 分钟内将一张图像转化为完整的网格化 3D 环境，非常适合快速启动 3D 工作。全速开干。

快速开始

1. 打开终端，输入 git clone https://github.com/neilsonnn/image-blaster
2. 进入目录：cd image-blaster
3. 运行 claude（安装命令：curl -fsSL https://claude.ai/install.sh | bash）
4. 向 Claude 问好，并提供你的 World Labs 和 FAL API 密钥。
5. 将一张图像放入 input/ 目录，然后让 Claude blast it and confirm each step with me。

描述

默认情况下，image-blaster 会使用你的输入图像创建：

1. 所有动态物体的 3D 模型（.glb、.obj）
2. 静态环境的高斯泼溅（.spz）
3. 环境循环音效和物体特定的物理音效（.mp3）

扩展

你可以将 image-blaster 嵌入任何游戏引擎、DCC 软件或 Web 应用的资源中。

1. Unity、Unreal 或 Godot 游戏引擎
2. Blender、3DS Max、Maya 或其他 DCC 软件
3. Three.js Web 应用或 Electron 应用

高级

IMAGE-BLASTER 使用了几个生成模型：

• marble-1.1 — World Labs Marble 模型，用于创建可探索的环境。
• nano-banana — 默认图像编辑偏好，用于源图像清理、干净背景和物体参考图像。
• gpt-image-2 — 当编辑技能要求优先使用时的备选图像编辑提供者。
• hunyuan-3d — Hunyuan 3D 模型，通过 FAL 创建 3D 物体模型。
• elevenlabs-sfx — ElevenLabs 音效模型，创建环境和物体特定音效。

3D 模型创建支持以下 Hunyuan 参数：

• --face-count <40000-1500000>：目标面数。IMAGE-BLASTER 默认值为 50000；Hunyuan API 默认值为 500000。
• --enable-pbr true|false：启用 PBR 材质生成。默认值为 true。
• --generate-type Normal|LowPoly|Geometry：Normal 创建带纹理的模型，LowPoly 应用多边形减面，Geometry 创建仅含白色几何体的模型。默认值为 Normal。
• --polygon-type triangle|quadrilateral：LowPoly 的多边形类型。默认值为 triangle。

示例

• 需要游戏关卡概念设计？IMAGE-BLAST 它。
• 童年卧室？IMAGE-BLAST 它。
• 需要为机器人创建环境？IMAGE-BLAST 它。
• 电影外景勘景？IMAGE-BLAST 它。
• 建筑渲染图？IMAGE-BLAST 它。

开发

• 从 .claudeignore 文件中移除 /app，以赋予 Claude 修改 React 查看器的能力。