gemini-image-remix

# Gemini Image Remix 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. ```bash 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. ```bash 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. ```bash 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. ```bash 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).