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>] [--model <id>] [--n N] [--out cover]
keryx cover --prompt "a fully-formed prompt …"      # bypass theme style + scene
Flag Meaning Default
--scene the per-post scene (required unless --prompt)
--prompt a fully-formed prompt used verbatim (bypasses theme style + scene)
--theme article theme (style prefix + aspect) configured article default
--model force a specific image model id config providers.gemini.model, else the fallback chain
--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.