image-gen — gpt-image-2 image generation (atomic capability)

A self-contained wrapper for gpt-image-2. Pure Python stdlib — no pip install, no venv. Runs through either provider, auto-picked by your key (override with --provider): OpenAI's native Images API directly, or OpenRouter's chat-completions image output (openai/gpt-5.4-image-2 is the same GPT Image 2 backend). Two modes, auto-selected by whether you pass --ref:

text-to-image — prompt only → /v1/images/generations.
image-to-image / edit — one or more --ref images → /v1/images/edits. Use a reference to lock a visual style, edit/extend an existing image, or combine multiple inputs. gpt-image-2 keeps the look of the reference(s) and applies the prompt.