Gemini Image Remix

Advanced image generation and remixing using Gemini. Supports Gemini 2.5 Flash Image (default) and models like Gemini 3.0 Pro (Nano Banana Pro).

A versatile tool for text-to-image generation and complex image-to-image remixing. By default, it uses Gemini 2.5 Flash Image for fast, high-quality results. It also supports flagship models like Gemini 3.0 Pro (Nano Banana Pro) for advanced artistic tasks.

Generate Image

Create stunning visuals from a text prompt.

uv run {baseDir}/scripts/remix.py --prompt "a cybernetic owl in a neon forest" --filename "owl.png"

Remix/Modify Image

Use one or more reference images to guide the generation. Perfect for style transfers, background changes, or character modifications.

uv run {baseDir}/scripts/remix.py --prompt "change the art style to a pencil sketch" --filename "sketch.png" -i "original.png"

Multi-image Composition

Combine elements from up to 14 different images into a single cohesive scene.

uv run {baseDir}/scripts/remix.py --prompt "place the character from image 1 into the environment of image 2" --filename "result.png" -i "character.png" -i "env.png"

Advanced Model Selection

Switch to advanced models like Nano Banana Pro for high-fidelity work.

uv run {baseDir}/scripts/remix.py --model "gemini-3-pro-image-preview" --prompt "highly detailed oil painting of a dragon" --filename "dragon.png"

Options

• --prompt, -p: Image description or specific edit instructions.
• --filename, -f: The output path for the generated PNG.
• --input-image, -i: Path to an input image (repeatable up to 14 times).
• --resolution, -r: 1K (default), 2K, or 4K.
• --aspect-ratio, -a: Output aspect ratio (e.g., 1:1, 16:9, 9:16, 4:3, 3:4).
• --model, -m: Model to use (defaults to gemini-2.5-flash-image). Supported: gemini-2.5-flash-image, gemini-3-pro-image-preview.
• --api-key, -k: Gemini API key (defaults to GEMINI_API_KEY env var).