| name | nanobanana |
| description | Generate images from a text prompt via OpenRouter's image generation API (Nano Banana / Gemini Flash Image). Displays the result inside the widget and saves to disk for download. |
| version | 0.2.4 |
| type | extension |
| runtime | python3 |
| entry | plugin.py |
| permissions | ["net","tool","route","widget","read_settings"] |
| env_from_settings | ["OPENROUTER_API_KEY"] |
| when_to_use | User wants to generate or render an image from a text description, right now, inside the web UI. Also saves the image to disk so it can be downloaded. |
| ui_tab | {"tab_id":"widget","title":"Nano Banana","icon":"image","render":{"kind":"declarative","schema_version":1,"components":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]}} |
Nano Banana image generation widget
An extension skill that renders a generator inside the Widgets tab. Type
a prompt, pick a model, press Generate, and the image appears directly in
the card. From v0.2.0 the image is also saved to disk and a Download image
button appears below it.
Backed by OpenRouter's image generation endpoint. Two Google models available:
the default is Nano Banana (google/gemini-3.1-flash-image-preview).
Persistence and download (v0.2.0)
From v0.2.0, every generation saves the image to the skill's private state
directory: ~/Ouroboros/data/state/skills/nanobanana/img_<12 hex chars>.<ext>.
Two separate routes serve the image:
GET /api/extensions/nanobanana/media?image_id=... — inline preview
(Content-Disposition: inline), used by the <img> tag in the widget.GET /api/extensions/nanobanana/download?image_id=... — attachment
download, sets proper filename so the file saves as img_<hex>.png.
Neither route requires the OPENROUTER_API_KEY grant — they serve files
already written to disk. A generated image stays accessible even if you later
revoke the generation grant.
Setup
- Put your OpenRouter API key into Ouroboros
Settings → Providers → OpenRouter.
- Run
review_skill(skill="nanobanana") and wait for a PASS verdict.
- On the Skills tab, click Grant access for
OPENROUTER_API_KEY.
The grant is content-hash-bound: any edit to this skill invalidates it.
- Enable the skill on the Skills tab.
- Open the Widgets tab — the Nano Banana card appears.
Usage
- Via the widget: type a prompt, optionally switch model, press Generate.
The image appears below the form; the Download image button saves it locally.
- Via the agent: call
ext_<token>_nanobanana_generate(prompt="...").
Returns JSON with file_path, image_id, image_url, download_url,
bytes, mime, model on success, or .
