nano-banana

nano-banana

AI 画像生成 CLI。デフォルトモデル：Gemini 3.1 Flash Image Preview（Nano Banana 2）。

/init - 初回セットアップ

ユーザーが「init」「setup nano-banana」または「install nano-banana」と言ったら、CLI ツールをマシンにインストールするため、以下のコマンドを実行します。sudo は不要です。

前提条件： Bun がインストールされている必要があります。インストールされていない場合：curl -fsSL https://bun.sh/install | bash

# 1. Clone the repo
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2

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

# 3. Link globally (creates `nano-banana` command via Bun - no sudo)
cd ~/tools/nano-banana-2 && bun link

# 4. Set up API key
mkdir -p ~/.nano-banana
echo "GEMINI_API_KEY=<ask user for their key>" > ~/.nano-banana/.env

init の後は、どこからでも nano-banana "prompt" と入力できます。

bun link が失敗する場合、またはリンク後にコマンドが見つからない場合は、次の方法に切り替えます。

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

Gemini API キーはこちらで取得できます：https://aistudio.google.com/apikey

クイックリファレンス

• コマンド：nano-banana "prompt" [options]
• デフォルト：1K 解像度、Flash モデル、カレントディレクトリ

主なオプション

オプション	デフォルト	説明
-o, --output	nano-gen-{timestamp}	出力ファイル名（拡張子なし）
-s, --size	1K	画像サイズ：512、1K、2K、または 4K
-a, --aspect	モデルのデフォルト	アスペクト比：1:1、16:9、9:16、4:3、3:4 など
-m, --model	flash	モデル：flash/nb2、pro/nb-pro、または任意のモデル ID
-d, --dir	カレントディレクトリ	出力ディレクトリ
-r, --ref	-	参照画像（複数回指定できます）
-t, --transparent	-	グリーンスクリーンで生成し、背景を削除（FFmpeg）
--api-key	-	Gemini API キー（環境変数／ファイルの値を上書き）
--costs	-	コストの概要を表示

モデル

エイリアス	モデル	使用する場面
flash, nb2	Gemini 3.1 Flash	デフォルト。高速で低コスト（画像 1K あたり約 $0.067）
pro, nb-pro	Gemini 3 Pro	最高品質が必要な場合（画像 1K あたり約 $0.134）

サイズ

サイズ	コスト（Flash）	コスト（Pro）
512	約 $0.045	Flash のみ
1K	約 $0.067	約 $0.134
2K	約 $0.101	約 $0.201
4K	約 $0.151	約 $0.302

アスペクト比

対応：1:1、16:9、9:16、4:3、3:4、3:2、2:3、4:5、5:4、21:9

-a フラグを使用します：nano-banana "cinematic scene" -a 16:9

主なワークフロー

基本的な生成

nano-banana "minimal dashboard UI with dark theme"
nano-banana "cinematic landscape" -s 2K -a 16:9
nano-banana "quick concept sketch" -s 512

モデルの選択

# Default (Flash - fast, cheap)
nano-banana "your prompt"

# Pro (highest quality)
nano-banana "detailed portrait" --model pro -s 2K

参照画像（スタイル転送／編集）

# Edit existing image
nano-banana "change the background to pure white" -r dark-ui.png -o light-ui

# Style transfer - multiple references
nano-banana "combine these two styles" -r style1.png -r style2.png -o combined

透過アセット

nano-banana "robot mascot character" -t -o mascot
nano-banana "pixel art treasure chest" -t -o chest

-t フラグを指定すると、AI にグリーンスクリーン上で生成するよう自動的に指示し、その後 FFmpeg の colorkey + despill を使って背景をキーアウトし、エッジピクセルの緑かぶりを除去します。手動でプロンプトを指定する必要なく、ピクセル単位で正確な透過画像を生成できます。

必要なもの：brew install ffmpeg imagemagick

正確な寸法

特定の出力寸法にするには：

1. 最初の -r フラグ：参照／スタイル画像
2. 最後の -r フラグ：目標の寸法に合わせた空白画像
3. プロンプトに寸法を含めます

nano-banana "pixel art character in style of first image, 256x256" -r style.png -r blank-256x256.png -o sprite

参照画像の順序が重要です

• 最初の参照画像：主なスタイル／コンテンツのソース
• 追加の参照画像：副次的な影響要素
• 最後の参照画像：出力寸法を制御します（空白画像を使う方法の場合）

コストの追跡

生成のたびに ~/.nano-banana/costs.json に記録されます。概要を確認するには：

nano-banana --costs

ユースケース

• ランディングページのアセット - 製品モックアップ、UI プレビュー
• 画像編集 - プロンプトを使って既存の画像を変換
• スタイル転送 - 複数の参照画像を組み合わせ
• マーケティング素材 - ヒーロー画像、機能紹介イラスト
• UI の反復 - デザインのバリエーションをすばやく生成
• 透過アセット - 背景なしのアイコン、ロゴ、マスコット
• ゲームアセット - スプライト、背景、キャラクター
• 動画制作 - 動画コンポジション用のビジュアル要素

プロンプト例

# UI mockups
nano-banana "clean SaaS dashboard with analytics charts, white background"

# Widescreen cinematic
nano-banana "cyberpunk cityscape at sunset" -a 16:9 -s 2K

# Product shots with Pro quality
nano-banana "premium software product hero image" --model pro

# Quick low-res concept
nano-banana "rough sketch of a robot" -s 512

# Dark mode UI
nano-banana "Premium SaaS chat interface, dark mode, minimal, Linear-style aesthetic"

# Game assets with transparency (green screen auto-prompted)
nano-banana "pixel art treasure chest" -t -o chest

# Portrait aspect ratio
nano-banana "mobile app onboarding screen" -a 9:16

API キーの設定

CLI は次の順序で Gemini API キーを解決します：

1. --api-key フラグ
2. GEMINI_API_KEY 環境変数
3. カレントディレクトリの .env ファイル
4. CLI スクリプトと同じ場所にある .env ファイル
5. ~/.nano-banana/.env

キーはこちらで取得できます：https://aistudio.google.com/apikey