nano-banana

Skill

Gemini-Image-Generator via CLI — Nano Banana 2 (Flash) für schnelle Konzepte, Pro für finale Assets. Style-Transfer, Green-Screen-Transparenz, Cost-Tracking.

Image-Generation via Google Gemini 3.1 Flash Image Preview (Nano Banana 2) und Gemini 3 Pro. Claude Code ruft die CLI mit natürlichen Prompts — Größen 512/1K/2K/4K, Aspect-Ratios von 1:1 bis 21:9, Reference-Images für Style-Transfer, -t-Flag für automatische Green-Screen-Transparenz via FFmpeg colorkey + despill. Jeder Aufruf wird in ~/.nano-banana/costs.json geloggt. Der Skill übersetzt Claude-Code-Tool-Calls in CLI-Aufrufe; das eigentliche Rendern passiert gegen die Gemini-API.

GitHub ↗Doku ↗

Kompatibel mit

Läuft mit diesen Hosts

nano-banana ist mit 1 App und 0 IDEs kompatibel — dort erscheint es automatisch auf jeder Constellation, die diesen Host als Komponente führt.

Apps · 1

Claude Code
Via Claude-Code-Marketplace-Plugin oder manuellem Symlink nach ~/.claude/skills/. CLI muss separat via `bun link` oder $PATH-Symlink global verfügbar sein.

Einrichtung

Bun + Gemini-API-Key reichen für den Start. Für Transparenz-Mode (-t-Flag) zusätzlich ffmpeg und imagemagick via Homebrew.

Voraussetzungen

Bun als Runtime (statt Node) — bun.sh. Schnell-Install: curl -fsSL https://bun.sh/install | bash
Gemini-API-Key von Google AI Studio
Für Transparenz-Mode (-t): brew install ffmpeg imagemagick

Installation — Hauptpfad (bun link)

# 1. Repo klonen — landet im persönlichen Tools-Verzeichnis
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2

# 2. Dependencies
cd ~/tools/nano-banana-2 && bun install

# 3. Global verfügbar machen — kein sudo dank Bun
bun link

# 4. API-Key ablegen
mkdir -p ~/.nano-banana
echo "GEMINI_API_KEY=<dein-key>" > ~/.nano-banana/.env

Smoke-Test aus einem beliebigen Verzeichnis:

nano-banana "minimal dashboard mockup"

Ergebnis: nano-gen-<timestamp>.png im aktuellen Ordner.

Installation — Fallback ohne `bun link`

Wenn bun link scheitert oder das Kommando danach nicht im $PATH auftaucht:

mkdir -p ~/.local/bin
ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Als Claude-Code-Skill aktivieren

Der Skill-Loader findet nano-banana automatisch, sobald das Plugin aus dem Claude-Code-Marketplace installiert ist — keine Symlinks nötig. Claude Code ruft die lokal installierte CLI auf, sobald die Skill-Beschreibung passt. Alternative: Repo clonen und den Skill-Ordner nach ~/.claude/skills/nano-banana/ symlinken.

Modelle & Preise

Alias	Modell	Kosten pro 1K-Image	Einsatz
`flash` / `nb2`	Gemini 3.1 Flash Image Preview	~$0.067	Default, Iterationen
`pro` / `nb-pro`	Gemini 3 Pro	~$0.134	Finale Assets

Beispiele

# Default: 1K, Flash
nano-banana "minimal dashboard UI, dark theme"

# Cinematic Widescreen mit Pro-Qualität
nano-banana "cyberpunk cityscape at sunset" --model pro -s 2K -a 16:9

# Transparentes Asset — Green-Screen + FFmpeg colorkey automatisch
nano-banana "pixel art treasure chest" -t -o chest

# Style-Transfer via Referenzbild
nano-banana "in the style of the reference" -r style.png -o remix

Kosten-Übersicht

Alle Aufrufe werden in ~/.nano-banana/costs.json geloggt:

nano-banana --costs

Im Einsatz

Diese Constellations nutzen nano-banana

Automatisch aus der Host-Kompatibilität abgeleitet — überall dort, wo einer der kompatiblen Hosts als Komponente geführt wird, erscheint nano-banana auch.