NanoBridge

Gemis Nano Banana-Bildgenerierung, eingebunden in Agenten als MCP-Server und CLI – unter Verwendung des Gemini-Plans, den das Konto bereits hat, nicht einer Rechnung pro Bild.

nanobridge sprite "a small knight with a blue shield and a silver sword" --size 160

Beide stammen aus den Befehlen in dieser README – das Sprite bereits beschnitten und transparent, die Animation bereits aus einem Sheet in Einzelbilder zerlegt und zu einem Endlos-GIF zusammengesetzt.

Warum nicht einfach die API aufrufen

Der AI-Studio-API-Schlüssel ist der naheliegende Weg, funktioniert aber nicht mit einem kostenlosen Plan: Jedes Bildmodell antwortet mit 429 RESOURCE_EXHAUSTED, weil der kostenlose Tarif null Bildkontingent gewährt. Die Aktivierung der Abrechnung behebt das und beginnt, pro Bild zu berechnen, während das Gemini-Abonnement, das bereits auf demselben Konto liegt, ungenutzt bleibt.

NanoBridge geht durch die andere Tür: Es authentifiziert sich so, wie es der Browser tut, mit dem __Secure-1PSID-Cookie, das bereits in Chrome vorhanden ist, und verbraucht das Kontingent des Abonnements. Nichts zum Einfügen, nichts zum Kaufen.

nanobridge doctor meldet, welches aktiv ist und wie viel Kontingent noch übrig ist.

Related MCP server: Nano Banana Pro MCP

Installation

git clone https://github.com/NspxMiguel/NanoBridge.git
cd NanoBridge && ./install.sh

Das Installationsprogramm erstellt eine virtualenv, setzt nanobridge auf den PATH, registriert den MCP-Server bei Claude Code und installiert die Agent-Fähigkeit. Homebrew:

brew install --cask nspxmiguel/tap/nanobridge

Voraussetzungen: Python 3.11+ und ein Browser, der bei https://gemini.google.com angemeldet ist.

Verwendung über die Shell

nanobridge doctor                        # backends, quota, config path
nanobridge sprite "a green slime" --style pixel --size 128
nanobridge icon "a compass rose" --style flat
nanobridge gen "a seamless stone wall texture, top-down, tileable"
nanobridge edit hero.png "make the sky stormy, keep everything else"

nanobridge sheet "a green slime" --grid 4x2 \
  --action "squash down and stretch back up, a bouncy idle loop" --fps 10

Sheets werden generiert, in Einzelbilder zerlegt und zu einem Endlos-GIF mit erhaltener Transparenz zusammengesetzt – GIF hat keinen Alphakanal, daher wird ein Palettenindex für die leeren Pixel reserviert.

Zwei Befehle berühren nie das Netzwerk, verbrauchen also kein Kontingent und funktionieren mit Bildern von überall:

nanobridge cut photo.jpg --transparent --trim --size 256
nanobridge slice sheet.png --grid 6x1 --size 96

Verwendung über einen Agenten

Der MCP-Server stellt generate_image, generate_sprite, generate_sprite_sheet, generate_icon, edit_image, cut_image, slice_sheet und nanobridge_status bereit.

Jedes generierende Werkzeug gibt das Bild an das Modell zurück, verkleinert auf eine 512px-Vorschau, zusammen mit den Pfaden auf der Festplatte. Das ist der Punkt: Ein Agent, der nicht sehen kann, was er gezeichnet hat, kann ein gutes Sprite nicht von einem kaputten unterscheiden und iteriert blind.

Manuelle Registrierung:

claude mcp add nanobridge --scope user -- /path/to/.venv/bin/nanobridge mcp

Was die Nachbearbeitung macht

Das Modell liefert ein großes JPEG auf einem einfarbigen Hintergrund. Sprites brauchen das Gegenteil, daher ist die Pipeline Teil des Werkzeugs und kein nachträglicher Gedanke:

• Hintergrundentfernung ist randverbunden, nicht farbabgeglichen. Ein weißes Auge in einem Sprite hat dieselbe Farbe wie das Weiß dahinter; nur der Bereich, der die Bildgrenze erreicht, wird gelöscht.

• Trimmen beschneidet auf die Zeichnung.

• Skalierung ist Nächster-Nachbar. Pixelkunst, die mit einem weichen Filter neu abgetastet wird, sieht nicht mehr wie Pixelkunst aus.

• Zerteilen ist geometrisch. Das im Prompt angeforderte Raster ist das Raster, das zum Schneiden verwendet wird, und die einzelnen Einzelbilder werden ausgegeben – dort sieht man, ob das Modell tatsächlich gehorcht hat.

Sprachen

Bildschirmtext ist Portugiesisch und Englisch. Das Systemgebietsschema wählt den Standard, nanobridge lang pt|en speichert eine Auswahl, und NANOBRIDGE_LANG=pt überschreibt beides für einen Lauf.

Wissenswerte Grenzen

• Das Web-Backend hängt von einer Browsersitzung ab. Wenn sie abläuft, melden Sie sich erneut bei https://gemini.google.com an; nanobridge doctor sagt das ausdrücklich.

• Es spricht mit einer Schnittstelle, die Google nicht dokumentiert, daher kann eine Änderung auf deren Seite es brechen. Das api-Backend ist der Fallback, der stabil bleibt.

• Generierte Bilder tragen Googles SynthID-Wasserzeichen.

Lizenz

MIT.