CLI

Single image — quick flood-fill cutout (no rembg)

Best for images generated with a flat solid background:

python scripts/asset_pipeline.py run `
  --input output/imagegen/item.png `
  --remove-bg-quick auto `
  --canvas 256x256 `
  --padding 16 `
  --out-dir output/assets/exported

--remove-bg-quick accepts:

• auto — sample the corner color (default)
• #RRGGBB — explicit background color, e.g. --remove-bg-quick #FFFFFF

Tune the cutout with --bg-tolerance (default 40; raise for softer backdrops, lower for edge cases).

Single image — AI cutout (rembg)

For complex backgrounds / shadows / hair / fur (downloads isnet-general-use model on first run):

python scripts/asset_pipeline.py run `
  --input output/imagegen/item.png `
  --remove-bg `
  --canvas 256x256 `
  --padding 16 `
  --out-dir output/assets/exported

Batch manifest

python scripts/asset_pipeline.py batch --manifest asset-pipeline.example.json

Typical manifest (quick cutout + sprite sheet):

{
  "out_dir": "output/assets/exported",
  "remove_bg": false,
  "remove_bg_quick": "auto",
  "bg_tolerance": 40,
  "trim": true,
  "padding": 16,
  "canvas": "256x256",
  "exports": ["png", "webp"],
  "sheet": "sprites.png",
  "items": [
    {
      "name": "potion_red",
      "input": "output/imagegen/potion-red.png"
    },
    {
      "name": "sword",
      "input": "output/imagegen/sword.png"
    }
  ]
}

Per-item fields override the top-level defaults. sheet composes every item's PNG output onto a fixed-column grid (sprites.png) and writes sprites.json with name / x / y / w / h per frame plus sheet dimensions — ready for a game engine atlas importer.

Notes

• out_dir and input paths in a manifest resolve relative to the manifest file.
• --remove-bg-quick and --remove-bg are mutually exclusive; quick wins.
• External optimizers (oxipng, pngquant) are used automatically when on PATH.