mcpField
G
generate-image

generate-image

github.com/cluesmithCreative & media294103 installsUpdated 1d ago
Repository

About generate-image

generate-image is a codev subcommand for generating images from text prompts with Google Gemini, with Atlas Cloud as an alternative provider. It supports output options such as aspect ratio, resolution, and reference images, depending on the provider.

Key features

  1. 01Text prompt to image generation
  2. 021K, 2K, and 4K resolution options
  3. 03Multiple aspect ratios
  4. 04Reference image input
  5. 05Gemini or Atlas Cloud provider

Use cases

  1. 01Generating an image from a written prompt
  2. 02Creating images in a specified aspect ratio
  3. 03Using reference images to guide Gemini output

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cluesmith/codev --skill generate-image

After installing, type/generate-imagein Claude Code to confirm it loaded.

Details

From the project README

generate-image - AI Image Generation

Uses Google Gemini to generate images from text prompts.

Synopsis

codev generate-image "<prompt>" [options]

Note: this is a codev subcommand, not standalone.

All flags

-o, --output <file>        Output file path (default: output.png)
-r, --resolution <res>     Resolution: 1K, 2K, 4K (default: 1K)
-a, --aspect <ratio>       Aspect ratio (default: 1:1)
--ref <image>              Reference image (repeatable, max 14)
-p, --provider <name>      Provider: gemini (default) or atlas

Aspect ratios

1:1 | 16:9 | 9:16 | 3:4 | 4:3 | 3:2 | 2:3

Examples

codev generate-image "A sunset over mountains"
codev generate-image "A futuristic city" -r 4K -a 16:9 -o city.png
codev generate-image "Same style but with cats" --ref style.png --ref layout.png
codev generate-image prompt.txt -o result.png    # Prompt from .txt file

Notes

  • Prompt must be quoted if it contains spaces
  • Prompt can be a .txt file path (auto-detected by extension)
  • Reference images must exist on disk
  • Requires GEMINI_API_KEY or GOOGLE_API_KEY environment variable

Alternative provider: Atlas Cloud

-p atlas generates through Atlas Cloud, which serves the same Nano Banana Pro model over a submit-then-poll REST API. Useful when a Google AI Studio key is not available. Requires ATLASCLOUD_API_KEY; the default provider is unchanged.

codev generate-image "A sunset over mountains" -p atlas -a 16:9

Measured differences on that path:

  • -a/--aspect works (1:1 returns 1024x1024, 16:9 returns 1376x768).
  • -r/--resolution has no equivalent field; a note is printed and the model's default resolution comes back.
  • --ref is not supported (text-to-image only) and exits with an error rather than silently ignoring the images.
  • The model returns JPEG, so the output file is named after its actual bytes instead of writing JPEG into the default output.png.

Comments

Markdown supported