Procedural 3D · Rust · glTF

Describe an asset.
Compile the mesh.

imaginu turns a tiny JSON recipe into a deterministic, game-ready GLB for Babylon.js - meshes, PBR vertex colors, skeletal animation and physics. No textures to wrangle, no C dependencies, byte-identical every time.

$ imaginu generate '{"kind":"tree","style":"oak"}' -o tree.glb --preview

LIVE · Babylon.js · real GLB output
loading engine…
drag to orbit · scroll to zoom · every model is a real imaginu-compiled .glb
The pipeline

Recipe in, engine-ready asset out.

Three deterministic steps. An agent (or you) writes the recipe; imaginu does the rest.

01 · describe

Write a recipe

A few lines of JSON name what you want. Run imaginu schema for the full contract - every kind and field.

02 · compile

Generate the GLB

imaginu generate builds the mesh, colors, skeleton, clips and a collider - then --preview renders a PNG so you can look.

03 · load

Drop it in

Load the .glb in Babylon.js like any glTF. Colliders ride along at extras.imaginu_physics.

Recipe → asset

The whole asset is the JSON on the left.

Real recipes from the repo, next to what imaginu compiles them into. Change a field, change a seed - the output is reproducible to the byte.

Built for agents

Hand it to Claude Code or Codex.

imaginu ships a first-class agent skill. The agent reads imaginu schema, writes a recipe, looks at the render, and iterates - from “make me an oak tree” to a loadable GLB, on its own.

▸ make me a glowing mystic crystal cluster for the shrine Reading the recipe contract… $ imaginu schema $ imaginu generate '{"kind":"crystal","palette":"mystic","seed":3}' \ -o shrine.glb --preview wrote shrine.glb (51 KiB, 446 triangles) wrote shrine.png ← looking at the render… Looks great - emissive shards on a rock base. Dropping shrine.glb into the Babylon scene; collider is at nodes[0].extras.imaginu_physics. Done.

Install the skill

One command per host. The skill stays DRY against imaginu schema, so it never goes stale.

  1. Claude Code - copy into ~/.claude/skills/
  2. Codex - a prompt file or your AGENTS.md
  3. It auto-installs the binary if it's missing
Claude Code
cp -r skill/imaginu ~/.claude/skills/imaginu

Read the skill →

Install

Running in about a minute.

Prebuilt static binaries for Linux, macOS and Windows - no Rust required - or straight from crates.io.

curl · no Rust needed
curl -fsSL https://raw.githubusercontent.com/vicotrbb/imaginu/main/install.sh | sh
cargo-binstall · prebuilt
cargo binstall imaginu
crates.io
cargo install imaginu
first render
imaginu generate '{"kind":"tree","style":"oak"}' -o tree.glb --preview

ffmpeg is optional - it's only needed for video (showcase, world --flyover). GLB generation and PNG previews are fully standalone.