hummer98/nanobanana-adc

README preview

# nanobanana-adc

English · [日本語](./README.ja.md)

![nanobanana-adc — Gemini 3 Pro Image CLI with ADC support](docs/generated/readme-hero.png)

> Gemini 3 Pro Image (Nano Banana Pro) CLI with first-class Application Default Credentials support — use Vertex AI from CI, Cloud Run, or any gcloud-authenticated workstation without handing out API keys.

## Why nanobanana-adc?

Most existing Claude Code skills for Gemini image generation (cc-nano-banana, ccskill-nanobanana, skill-nano-banana, and similar) only accept a `GEMINI_API_KEY`. That leaves a gap for enterprise environments, CI/CD pipelines, and Cloud Run deployments where API keys are discouraged and Vertex AI with Application Default Credentials (ADC) is the required authentication path.

**nanobanana-adc exists to fill that gap.** ADC support is its single differentiating axis. If you already have `gcloud auth application-default login` configured, a service account attached to your workload, or `GOOGLE_APPLICATION_CREDENTIALS` pointing at a JSON key, this CLI will pick it up automatically — no key handling required.

## Features

- ADC authentication via `google-auth-library` (default).
- `GEMINI_API_KEY` fallback for lightweight setups.
- 10 aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 5:4.
- 3 resolutions: 1K, 2K, 4K.

View full repository on GitHub →