NanoBridge

La generación de imágenes Nano Banana de Gemini, conectada a agentes como un servidor MCP y una CLI, usando el plan de Gemini que la cuenta ya tiene, no una factura por imagen.

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

Ambas salieron de los comandos de este README: el sprite ya recortado y transparente, la animación ya cortada de una hoja y ensamblada en un GIF en bucle.

Por qué no simplemente llamar a la API

La clave de API de AI Studio es la ruta obvia y no funciona en un plan gratuito: cada modelo de imagen responde 429 RESOURCE_EXHAUSTED, porque el nivel gratuito concede cero cuota de imágenes. Activar la facturación lo arregla y empieza a cobrar por imagen, mientras que la suscripción a Gemini que ya está en la misma cuenta queda sin usar.

NanoBridge toma la otra puerta: se autentica como lo hace el navegador, con la cookie __Secure-1PSID ya en Chrome, y gasta la cuota de la suscripción. Nada que pegar, nada que comprar.

nanobridge doctor informa cuál está activo y cuánta cuota queda.

Related MCP server: Nano Banana Pro MCP

Instalación

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

El instalador crea un virtualenv, pone nanobridge en PATH, registra el servidor MCP con Claude Code e instala la habilidad del agente. Homebrew:

brew install --cask nspxmiguel/tap/nanobridge

Requisitos: Python 3.11+ y un navegador con sesión iniciada en https://gemini.google.com.

Úsalo desde la terminal

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

Las hojas se generan, se cortan en fotogramas y se ensamblan en un GIF en bucle con la transparencia preservada: el GIF no tiene canal alfa, así que se reserva un índice de paleta para los píxeles vacíos.

Dos comandos nunca tocan la red, así que no cuestan cuota y funcionan con imágenes de cualquier lugar:

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

Úsalo desde un agente

El servidor MCP expone generate_image, generate_sprite, generate_sprite_sheet, generate_icon, edit_image, cut_image, slice_sheet y nanobridge_status.

Cada herramienta de generación devuelve la imagen de vuelta al modelo, reducida a una vista previa de 512px, junto con las rutas en disco. Ese es el punto: un agente que no puede ver lo que dibujó no puede distinguir un buen sprite de uno roto, e itera a ciegas.

Registrándolo a mano:

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

Qué hace el postprocesado

El modelo devuelve un JPEG grande sobre un fondo plano. Los sprites necesitan lo contrario, así que el pipeline es parte de la herramienta, no una idea posterior:

• La eliminación del fondo está conectada al borde, no coincide con el color. Un ojo blanco dentro de un sprite tiene el mismo color que el blanco detrás; solo se borra la región que llega al borde de la imagen.

• Recorte recorta hasta el dibujo.

• El redimensionado es de vecino más cercano. El arte de píxeles remuestreado con un filtro suave deja de parecer arte de píxeles.

• El corte es geométrico. La cuadrícula pedida en el prompt es la cuadrícula usada para cortar, y los fotogramas individuales se escriben: ahí es donde ves si el modelo realmente obedeció.

Idiomas

El texto en pantalla está en portugués e inglés. La configuración regional del sistema elige el predeterminado, nanobridge lang pt|en guarda una elección, y NANOBRIDGE_LANG=pt anula ambos para una ejecución.

Límites que vale la pena conocer

• El backend web depende de una sesión de navegador. Cuando caduca, inicia sesión de nuevo en https://gemini.google.com; nanobridge doctor lo dice explícitamente.

• Habla con una interfaz que Google no documenta, así que un cambio de su lado puede romperlo. El backend api es el respaldo que permanece.

• Las imágenes generadas llevan la marca de agua SynthID de Google.

Licencia

MIT.