Skip to content

keryx cover

Generate cover art via the image provider (Gemini/Imagen) — a port of the blog gen-cover.py. Resolves an article theme for the style prefix + aspect and appends the per-post --scene.

keryx cover --scene "a quiet desk at dawn" [--theme <article-kw>] [--n N] [--out cover]
Flag Meaning Default
--scene the per-post scene (required)
--theme article theme (style prefix + aspect) configured article default
--n number of candidate samples 1
--out output path prefix → <out>-<i>.png cover

Credential: GEMINI_API_KEY (env). Image generation is non-deterministic — make several samples and pick a clean one. Add --output json for the list of paths.

keryx cover --scene "an over-engineered toaster, one idea" --theme editorial --n 4
# writes cover-1.png … cover-4.png

Provider-selected via providers.image (default Gemini) — see Providers. Tries the Imagen models, falling back to the Gemini image models (parity with the script). R-GEN-1..3.