novafarma/docs/BATCH_GENERATION_README.md

🚀 BATCH ASSET GENERATION

Avtomatska generacija 126 assetov z dual-style sistemom.

Quick Start

# Start generation
python3 scripts/batch_generation_runner.py

Features

✅ 126 assetov (63 base × 2 styles)
✅ Live progress tracking - vidiš koliko je narejeno
✅ Preview creation - 256x256 slike za ogled
✅ Auto logging - v logs/ mapi
✅ Resume capability - če se prekine, nadaljuj
✅ ETA calculation - ocena preostanka časa

What It Does

1. Reads manifest - BATCH_GENERATION_MANIFEST.json
2. Generates images - Uses Gemini 2.0 Flash
3. Saves to folders - Proper demo/ structure
4. Creates previews - 256x256 for viewing
5. Logs everything - Progress + errors

Generated Assets

Kai Animations (28)

• Run East/West (8 frames)
• Weapon actions (sword, axe)
• Portraits (neutral, happy, sad)

Zombies (22)

• Walk cycle (4 frames)
• Attack cycle (4 frames)
• Variants (runner, bloated, corpse)

Terrain (22)

• Grass variations (4)
• Stone paths (4)
• Corners (4)

Environment (26)

• Trees (oak, pine, dead)
• Rocks (small, medium, large)
• Plants (bushes, flowers, grass, weeds)

Buildings (12)

• Shack, campfire, well
• Storage, scarecrow, compost

NPCs (16)

• Trader, Blacksmith
• Healer, Traveler

Live Monitoring

While running:

# In another terminal, watch progress:
tail -f logs/batch_generation_*.log

# Or check latest images:
ls -lt assets/images/demo/characters/ | head

If Interrupted

Resume from last position:

# It will tell you the asset number
python3 scripts/batch_generation_runner.py --resume 45

Output Structure

assets/images/demo/
  characters/
    kai_run_east_1_styleA.png
    kai_run_east_1_styleA_preview_256x256.png
    kai_run_east_1_styleB.png
    kai_run_east_1_styleB_preview_256x256.png
    ...
  terrain/
  environment/
  buildings/
  npcs/

Timing

• Per asset: ~15 seconds
• Total time: ~30-60 minutes
• 126 assets with previews

After Generation

1. Check previews in each folder
2. Run background removal:

   python3 scripts/remove_bg_advanced.py assets/images/demo/
   

3. Organize into subfolders:

   python3 scripts/organize_all_assets.py
   

---

Created: 2025-12-31
Status: Ready to run! 🚀