Ghostlight/scripts/README.md
2026-05-05 01:49:45 +01:00

1.3 KiB

Ghostlight Scripts

Visual Image Inventory

count_visual_images.py counts base images and branch/state variants declared by Ghostlight .visual.json plans. Use it before committing to an illustrated IF fixture so the render burden is visible instead of quietly breeding in a vent.

Run the default inventory:

& 'C:\Users\Meta\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' .\scripts\count_visual_images.py

Run with per-scene detail:

& 'C:\Users\Meta\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' .\scripts\count_visual_images.py --verbose

BFL Image Batches

generate_bfl_images.py submits a compact prompt manifest to the BFL async image API, polls the returned status URL, downloads signed results immediately, and writes a local run manifest. Generated images belong under experiments/images/, which is ignored by git.

Run the Corvid simple-prompt batch:

& 'C:\Users\Meta\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe' .\scripts\generate_bfl_images.py .\prompts\image-generation\corvid-collective-founding.bfl-simple-prompts.v0.json --out-dir .\experiments\images\corvid-collective-founding-v0\bfl --skip-existing --continue-on-error