imgenv0.3.1

Showcase

Each example shows real output produced by imgen itself, from files in the project repository. Input on the left, output on the right.

Command reference

examples/help.txtDetail: Command reference
imgen --help
CLI tool to generate images via the Replicate API

Usage: imgen [OPTIONS] [PROMPT]

Arguments:
  [PROMPT]  Text prompt for image generation (ignored when --prompt-file is used)

Options:
      --prompt-file <FILE>  JSON file containing an array of jobs
      --model <MODEL>       Replicate model in "owner/name" format [default: black-forest-labs/flux-1.1-pro]
      --width <WIDTH>       Output width in pixels [default: 1024]
      --height <HEIGHT>     Output height in pixels [default: 768]
      --out <OUT>           Output file path (only used for single-prompt mode) [default: output.png]
      --webp [<WEBP>]       Convert output to WebP with given quality (0-100). Omit value for default 80
  -h, --help                Print help
  -V, --version             Print version
  • options
  • defaults

Missing API token

examples/missing-token.txtDetail: Missing API token
env -u REPLICATE_API_TOKEN imgen "A sunset over the ocean"
Error: Environment variable REPLICATE_API_TOKEN is not set

Caused by:
    environment variable not found
exit code 1
  • setup
  • error

No prompt given

examples/missing-prompt.txtDetail: No prompt given
imgen
Error: Either a prompt argument or --prompt-file is required
exit code 1
  • validation
  • error

Batch job without output path

examples/missing-out.txtDetail: Batch job without output path
[
  { "prompt": "A mountain landscape", "out": "images/mountain.png" },
  { "prompt": "A cityscape at night" }
]
Error: Failed to parse prompt file examples/prompt-files/missing-out.json

Caused by:
    0: Failed to parse jobs array
    1: missing field `out`
exit code 1
  • batch
  • validation

Empty batch

examples/empty-batch.txtDetail: Empty batch
{
  "defaults": { "model": "black-forest-labs/flux-schnell" },
  "jobs": []
}
Error: Prompt file contains no jobs
exit code 1
  • batch
  • validation

Gallery: Laptop with a terminal

examples/gallery/ki-bilder-kommandozeile-mac-api-lokal.webpDetail: Gallery: Laptop with a terminal
imgen 'Bold glowing title text at top: "KI-Bilder per Kommandozeile". Vibrant 3D isometric illustration of a sleek laptop with a terminal console on screen, surrounded by colorful AI-generated artwork bursting out of the screen like magic portals, floating brushstrokes, light particles, and holographic imagery swirling around. Dark moody background with neon accent colors purple and cyan, digital art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out ki-bilder-kommandozeile-mac-api-lokal.png
Isometric 3D illustration of a laptop on a glowing platform with a terminal window on the screen and colourful ribbons, bubbles and particles bursting out behind it, on a dark grid. At the top the glowing headline “Ki-Bilder per Kommandozeile”.
  • gallery
  • ideogram-v3-quality

Gallery: Server rack and clouds

examples/gallery/cloud-exit-strategie-souveraene-architektur.webpDetail: Gallery: Server rack and clouds
imgen 'Bold glowing title text at top: "Raus aus der Cloud?". 3D isometric server rack with glowing escape route arrows pointing outward, a European map hologram floating behind it, data streams breaking free from cloud symbols. Dark background with electric blue and red neon accents, digital art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out cloud-exit-strategie-souveraene-architektur.png
Isometric 3D server rack under a holographic globe showing Europe, with glowing cables running from two clouds on the left and right and white arrows pointing at the rack, dark background with blue and red light. At the top the headline “RAUS AUS DER CLOUD?” in glowing white capitals.
  • gallery
  • ideogram-v3-quality

Gallery: Staircase of code blocks

examples/gallery/supply-chain-security-karriere-entwickler.webpDetail: Gallery: Staircase of code blocks
imgen 'Bold glowing title text at top: "Security als Karrierepfad". 3D isometric rising staircase made of code blocks and shield icons, each step glowing brighter toward the top, terminal windows and lock symbols floating alongside the ascending path. Dark background with electric blue and green neon accents, digital art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out supply-chain-security-karriere-entwickler.png
3D staircase built from blue and green blocks rising to the right, with floating code windows, shield icons and padlocks beside it, on a dark grid floor. At the top the headline “SECURITY ALS KARRIEREPFAD” in glowing white capitals with a green glow.
  • gallery
  • ideogram-v3-quality

Gallery: Grid of UI components

examples/gallery/warum-sich-design-systems-rechnen.webpDetail: Gallery: Grid of UI components
imgen 'Bold glowing title text at top: "Design Systems rechnen sich". 3D isometric grid of UI components — buttons, cards, color swatches, typography tokens — floating in organized layers, connected by glowing lines forming a system. Dark background with cyan and magenta neon accents, flat vector art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out warum-sich-design-systems-rechnen.png
Isometric grid of rounded UI component tiles – cards, buttons and groups of coloured dots in red, cyan, yellow and grey – on a dark grid, framed by a neon line fading from cyan to purple. At the top the headline “Design Systems rechnen Sich” in glowing white letters.
  • gallery
  • ideogram-v3-quality

Gallery: Stone blocks turning into puzzle pieces

examples/gallery/tod-der-vererbung-composition-traits-protokolle.webpDetail: Gallery: Stone blocks turning into puzzle pieces
imgen 'Bold glowing title text at top: "Der Tod der Vererbung". Crumbling 3D class hierarchy tree shattering into fragments, modern glowing composition blocks and trait puzzle pieces assembling from the debris, energy sparks at the transition point. Dark background with red and electric blue neon accents, digital art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out tod-der-vererbung-composition-traits-protokolle.png
Rows of cracked stone blocks on the left crumbling into a pile of rubble, turning into blue puzzle pieces on the right, with red and blue neon lines in the lower corners. At the top the headline “DER TOD DER VERERBUNG” in glowing yellow capitals.
  • gallery
  • ideogram-v3-quality

Gallery: Rocket and old machine

examples/gallery/modernisierung-ist-kein-ziel.webpDetail: Gallery: Rocket and old machine
imgen 'Bold glowing title text at top: "Modernisierung ist kein Ziel". 3D isometric illustration of a shiny new rocket standing idle next to a reliable old machine that is actually running and producing output, sparks and gears in motion around the old machine. Dark background with amber and electric blue neon accents, digital art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out modernisierung-ist-kein-ziel.png
Isometric scene of a white rocket standing idle next to a small metal machine on wheels that shoots a stream of orange sparks, on a dark tiled floor with blue neon edges and more sparks on the left. At the top the headline “MODERNISIERUNG IST KEIN ZIEL” in glowing white capitals.
  • gallery
  • ideogram-v3-quality

Gallery: Conveyor belt with a stop sign

examples/gallery/ki-slop-test-wann-keine-ki-nutzen.webpDetail: Gallery: Conveyor belt with a stop sign
imgen 'Bold glowing title text at top: "Der KI-Slop-Test". 3D illustration of a conveyor belt producing identical generic documents, a large red STOP sign slamming down on the belt, rejected AI slop flying off into a glowing trash vortex. Dark background with red and purple neon accents, digital art style, dramatic lighting' \
  --model ideogram-ai/ideogram-v3-quality \
  --width 1000 --height 1080 \
  --out ki-slop-test-wann-keine-ki-nutzen.png
Conveyor belt carrying identical paper documents labelled “AI”, a large red octagonal STOP sign on the belt and a bin of shredded paper behind it, more documents flying through the air, dark red and purple background. At the top the headline “DER KI-SLOP-TEST” in glowing white capitals.
  • gallery
  • ideogram-v3-quality