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 — это набор навыков (skillset) для Claude, который превращает одно изображение в 3D-окружение с мешами и звуковыми эффектами, координируя навыки Claude вместе с API World Labs и FAL.
Это навык Claude или самостоятельное приложение?В первую очередь это навык Claude: вы указываете Claude на изображение, и он вызывает внешние API, чтобы собрать 3D-сцену. Также в комплекте есть встроенное React-приложение для просмотра (в папке /app), с помощью которого можно просматривать и дорабатывать результат.
Как это запустить?Клонируйте репозиторий и используйте входящие в комплект скрипты для запуска просмотрщика: 'bun --cwd=app run dev' запускает его локально, а 'bun --cwd=app run build' собирает сборку для продакшена; сам навык вызывается через Claude.
Нужны ли API-ключи для World Labs и FAL?Да — image-blaster использует сервисы World Labs и FAL (а при желании и 3D API Hunyuan) для генерации меша и окружения, поэтому для работы нужен доступ к этим API.
Можно ли контролировать качество мешей и стиль результата?Да, с помощью флагов: --enable-pbr включает PBR-материалы (по умолчанию включено), --generate-type выбирает вывод Normal, LowPoly или Geometry-only, а --polygon-type задаёт треугольные или четырёхугольные полигоны для LowPoly. Целевое количество граней по умолчанию — 50000, что заметно меньше значения по умолчанию у API Hunyuan — 500000.
Какие изображения подходят лучше всего?Проект позиционируется для концептов уровней видеоигр, детских спален, роботизированных окружений, поиска локаций для кино и архитектурных визуализаций — по сути, для любого отдельного референсного изображения, которое вы хотите превратить в исследуемое 3D-пространство.
Можно ли настроить приложение-просмотрщик?Да — если удалить /app из файла .claudeignore, Claude получит разрешение напрямую редактировать встроенное React-приложение для просмотра.
Почему Hunyuan упоминается вместе с World Labs и FAL?Похоже, API Hunyuan используется в качестве бэкенда генерации меша (или наряду с другими сервисами): его значение по умолчанию в 500000 граней заметно выше, чем у image-blaster — 50000.
Creator
neilsonnn
Size
19.5 MB
Stars
11.4K
Updated
CommitMay 15
Age
5mo
Commits · 90 Days