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. リポジトリをクローン
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2

# 2. 依存関係をインストール
cd ~/tools/nano-banana-2 && bun install

# 3. グローバルにリンク (Bunで `nano-banana` コマンドを作成 - sudoなし)
cd ~/tools/nano-banana-2 && bun link

# 4. APIキーをセットアップ
mkdir -p ~/.nano-banana
echo "GEMINI_API_KEY=<ask user for their key>" > ~/.nano-banana/.env

初回セットアップ後、ユーザーはどこからでも nano-banana "prompt" コマンドを実行できます。

bun link に失敗した場合またはリンク後にコマンドが見つからない場合は、以下にフォールバックしてください:

mkdir -p ~/.local/bin
ln -sf ~/tools/nano-banana-2/src/cli.ts ~/.local/bin/nano-banana
# その後、 ~/.local/bin が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	デフォルト。高速、低価格 (~$0.067/1K画像)
pro, nb-pro	Gemini 3 Pro	最高品質が必要な場合 (~$0.134/1K画像)

サイズ

サイズ	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

モデル選択

# デフォルト (Flash - 高速、低価格)
nano-banana "your prompt"

# Pro (最高品質)
nano-banana "detailed portrait" --model pro -s 2K

参照画像 (スタイル転送 / 編集)

# 既存の画像を編集
nano-banana "change the background to pure white" -r dark-ui.png -o light-ui

# スタイル転送 - 複数の参照画像
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にグリーンスクリーンで生成するよう指示し、FFmapegの 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モックアップ
nano-banana "clean SaaS dashboard with analytics charts, white background"

# ワイドスクリーンシネマティック
nano-banana "cyberpunk cityscape at sunset" -a 16:9 -s 2K

# Pro品質での製品ショット
nano-banana "premium software product hero image" --model pro

# クイック低解像度コンセプト
nano-banana "rough sketch of a robot" -s 512

# ダークモードUI
nano-banana "Premium SaaS chat interface, dark mode, minimal, Linear-style aesthetic"

# 透明性付きゲームアセット (グリーンスクリーン自動プロンプト)
nano-banana "pixel art treasure chest" -t -o chest

# ポートレートアスペクト比
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