CommunityImagemgithub.com

steipete/nano-banana-pro

Geração/edição de imagens com Nano Banana (Gemini): entrada de texto/imagem, fluxos de trabalho de 512 a 4K.

O que é nano-banana-pro?

Esta skill permite gerar novas imagens ou editar imagens existentes usando a API Nano Banana 2 (Gemini 3.1 Flash Image) do Google. É ideal para desenvolvedores e usuários de agentes de IA que precisam criar ou modificar imagens rapidamente, a partir de descrições textuais ou imagens de referência, com resoluções que variam de 512 px até 4K. A skill é compatível com qualquer ambiente que execute scripts Python com `uv`, como Claude Code, Cursor ou Codex. O fluxo de trabalho recomendado é de rascunho para final: comece com resolução 1K para iterações rápidas e só use 4K quando o prompt estiver pronto. Para edição, basta fornecer o caminho da imagem original e as instruções de alteração. A chave da API Gemini (GEMINI_API_KEY) pode ser passada como argumento ou variável de ambiente. A skill gera nomes de arquivo padronizados com timestamp para facilitar a organização.

Funciona com~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/nano-banana-pro

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Nano Banana 2 – Geração e Edição de Imagens

Gere novas imagens ou edite imagens existentes usando a API Nano Banana 2 do Google (Gemini 3.1 Flash Image).

Uso

Execute o script usando o caminho absoluto (NÃO entre no diretório da skill antes):

Gerar nova imagem:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "sua descrição da imagem" --filename "nome-da-saida.png" [--resolution 512|1K|2K|4K] [--api-key KEY]

Editar imagem existente:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "instruções de edição" --filename "nome-da-saida.png" --input-image "caminho/para/imagem.png" [--resolution 512|1K|2K|4K] [--api-key KEY]

Importante: Sempre execute a partir do diretório de trabalho atual do usuário para que as imagens sejam salvas onde o usuário está trabalhando, e não no diretório da skill.

Fluxo de Trabalho Padrão (rascunho → iterar → final)

Objetivo: iteração rápida sem gastar tempo em 4K até que o prompt esteja correto.

  • Rascunho (1K): ciclo de feedback rápido
    • uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<prompt do rascunho>" --filename "aaaa-mm-dd-hh-mm-ss-rascunho.png" --resolution 1K
  • Iterar: ajuste o prompt com pequenas diferenças; mantenha um novo nome de arquivo a cada execução
    • Se for edição: mantenha o mesmo --input-image a cada iteração até ficar satisfeito.
  • Final (4K): somente quando o prompt estiver pronto
    • uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<prompt final>" --filename "aaaa-mm-dd-hh-mm-ss-final.png" --resolution 4K

Opções de Resolução

A API Gemini 3.1 Flash Image suporta estes valores de tamanho de saída:

  • 512 – compacto, resolução ~512px
  • 1K (padrão) – resolução ~1024px
  • 2K – resolução ~2048px
  • 4K – resolução ~4096px

Mapeie as solicitações do usuário para os parâmetros da API:

  • "512", "512px", "0.5K", "miniatura", "pequeno" → 512
  • Sem menção de resolução → 1K
  • "baixa resolução", "1080", "1080p", "1K" → 1K
  • "2K", "2048", "normal", "resolução média" → 2K
  • "alta resolução", "alta-res", "hi-res", "4K", "ultra" → 4K

Chave da API

O script verifica a chave da API nesta ordem:

  1. Argumento --api-key (use se o usuário forneceu a chave no chat)
  2. Variável de ambiente GEMINI_API_KEY

Se nenhuma estiver disponível, o script sai com uma mensagem de erro.

Verificação Prévia + Falhas Comuns (correções rápidas)

  • Verificação prévia:

    • command -v uv (deve existir)
    • test -n "$GEMINI_API_KEY" (ou passe --api-key)
    • Se edição: test -f "caminho/para/imagem.png"
  • Falhas comuns:

    • Error: No API key provided. → defina GEMINI_API_KEY ou passe --api-key
    • Error loading input image: → caminho errado / arquivo ilegível; verifique se --input-image aponta para uma imagem real
    • Erros de API do tipo "quota/permission/403" → chave errada, sem acesso ou cota excedida; tente outra chave/conta

Geração de Nomes de Arquivo

Gere nomes de arquivo com o padrão: aaaa-mm-dd-hh-mm-ss-nome.png

Formato: {timestamp}-{nome-descritivo}.png

  • Timestamp: Data/hora atual no formato aaaa-mm-dd-hh-mm-ss (formato 24h)
  • Nome: Texto descritivo em minúsculas com hífens
  • Mantenha a parte descritiva concisa (normalmente 1 a 5 palavras)
  • Use o contexto do prompt ou da conversa do usuário
  • Se não estiver claro, use um identificador aleatório (ex.: x9k2, a7b3)

Exemplos:

  • Prompt "Um jardim japonês sereno" → 2025-11-23-14-23-05-jardim-japones.png
  • Prompt "pôr do sol sobre montanhas" → 2025-11-23-15-30-12-por-sol-montanhas.png
  • Prompt "crie uma imagem de um robô" → 2025-11-23-16-45-33-robo.png
  • Contexto não claro → 2025-11-23-17-12-48-x9k2.png

Edição de Imagens

Quando o usuário deseja modificar uma imagem existente:

  1. Verifique se ele forneceu um caminho de imagem ou fez referência a uma imagem no diretório atual
  2. Use o parâmetro --input-image com o caminho para a imagem
  3. O prompt deve conter instruções de edição (ex.: "deixe o céu mais dramático", "remova a pessoa", "mude para estilo cartoon")
  4. Tarefas comuns de edição: adicionar/remover elementos, mudar estilo, ajustar cores, desfocar fundo, etc.

Tratamento de Prompts

Para geração: Passe a descrição da imagem do usuário diretamente em --prompt. Só reformule se estiver claramente insuficiente.

Para edição: Passe as instruções de edição em --prompt (ex.: "adicione um arco-íris no céu", "faça parecer uma pintura em aquarela")

Preserve a intenção criativa do usuário em ambos os casos.

Modelos de Prompt (alta taxa de acerto)

Use modelos quando o usuário for vago ou quando as edições precisarem ser precisas.

  • Modelo de geração:

    • "Crie uma imagem de: . Estilo: . Composição: <câmera/enquadramento>. Iluminação: <iluminação>. Fundo: . Paleta de cores: . Evite: ."
  • Modelo de edição (preserve todo o resto):

    • "Altere APENAS: <única alteração>. Mantenha idênticos: assunto, composição/corte, pose, iluminação, paleta de cores, fundo, texto e estilo geral. Não adicione novos objetos. Se houver texto, mantenha-o inalterado."

Saída

  • Salva PNG no diretório atual (ou no caminho especificado se o nome do arquivo incluir diretório)
  • O script exibe o caminho completo da imagem gerada
  • Não leia a imagem de volta – apenas informe ao usuário o caminho salvo

Exemplos

Gerar nova imagem:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "Um jardim japonês sereno com cerejeiras" --filename "2025-11-23-14-23-05-jardim-japones.png" --resolution 4K

Editar imagem existente:

uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "deixe o céu mais dramático com nuvens de tempestade" --filename "2025-11-23-14-25-30-ceu-dramatico.png" --input-image "foto-original.jpg" --resolution 2K

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas