mcpField
N
nanobanana-skill

nanobanana-skill

github.com/feiskyerクリエイティブ・メディア1.7k321 回インストール4 週間前に更新
リポジトリ

nanobanana-skill について

nanobananaツールを通じてGoogle Gemini APIで画像を生成・編集するスキルです。Pythonスクリプトを実行し、モデル、サイズ、解像度を選べます。

主な機能

  1. 01テキストプロンプトから画像生成
  2. 021枚または複数画像の編集
  3. 03Gemini画像モデルの選択
  4. 04アスペクト比と解像度の指定
  5. 05Google Search groundingの任意設定

活用シーン

  1. 01文章で指定した画像の作成
  2. 02既存画像への指示に基づく変更

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/feiskyer/claude-code-settings --skill nanobanana-skill

インストール後、Claude Code で/nanobanana-skillを入力して読み込まれたか確認します。

同梱ファイルnanobanana.pyrequirements.txt

詳細

Nanobanana 画像生成スキル

nanobanana ツールを通じて Google Gemini API を使用し、画像を生成または編集します。

要件

  1. GEMINI_API_KEY：~/.nanobanana.env で設定するか、export GEMINI_API_KEY=<your-api-key> を実行する必要があります
  2. 依存パッケージをインストールした Python3：google-genai、Pillow、python-dotenv が必要です。まだインストールされていない場合は、python3 -m pip install -r ${CLAUDE_SKILL_DIR}/requirements.txt でインストールできます。
  3. 実行可能ファイル：${CLAUDE_SKILL_DIR}/nanobanana.py

手順

画像を生成する場合

  1. ユーザーに次の内容を尋ねます：

    • 作成したいもの（プロンプト）
    • 希望するアスペクト比／サイズ（任意。デフォルトは縦向きの 9:16）
    • 出力ファイル名（任意。指定されていない場合は UUID を自動生成）
    • モデルの希望（任意。デフォルトは gemini-3.1-flash-image-preview）
    • 解像度（任意。デフォルトは 1K）

  2. 適切なパラメーターを指定して nanobanana スクリプトを実行します：

    python3 ${CLAUDE_SKILL_DIR}/nanobanana.py --prompt "description of image" --output "filename.png"

  3. 完了したら、保存された画像のパスをユーザーに提示します

画像を編集する場合

  1. ユーザーに次の内容を尋ねます：

    • 編集する入力画像ファイル
    • 変更したい内容（プロンプト）
    • 出力ファイル名（任意）

  2. 入力画像を指定して実行します：

    python3 ${CLAUDE_SKILL_DIR}/nanobanana.py --prompt "editing instructions" --input image1.png image2.png --output "edited.png"

使用可能なオプション

アスペクト比（--size）
  • 1024x1024 (1:1) - 正方形
  • 832x1248 (2:3) - 縦向き
  • 1248x832 (3:2) - 横向き
  • 864x1184 (3:4) - 縦向き
  • 1184x864 (4:3) - 横向き
  • 896x1152 (4:5) - 縦向き
  • 1152x896 (5:4) - 横向き
  • 768x1344 (9:16) - 縦向き（デフォルト）
  • 1344x768 (16:9) - 横向き
  • 1536x672 (21:9) - 超横長
モデル（--model）
  • gemini-3.1-flash-image-preview（デフォルト） - 最新の高速生成モデル
  • gemini-3-pro-image-preview - 高品質で、思考・推論に対応
解像度（--resolution）
  • 1K（デフォルト）
  • 2K
  • 4K
その他のオプション
  • --no-search - Google Search のグラウンディングを無効化します（デフォルトでは有効）
  • --no-think - 思考・推論モードを無効化します

例

シンプルな画像を生成する
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py --prompt "A serene mountain landscape at sunset with a lake"
サイズと出力先を指定して生成する
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Modern minimalist logo for a tech startup" \
  --size 1024x1024 \
  --output "logo.png"
高解像度で横向きの画像を生成する
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Futuristic cityscape with flying cars" \
  --size 1344x768 \
  --resolution 2K \
  --output "cityscape.png"
既存の画像を編集する
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Add a rainbow in the sky" \
  --input photo.png \
  --output "photo-with-rainbow.png"
高品質な画像を生成するために Pro モデルを使用する
python3 ${CLAUDE_SKILL_DIR}/nanobanana.py \
  --prompt "Detailed portrait of a cat in watercolor style" \
  --model gemini-3-pro-image-preview \
  --output "cat-portrait.png"

エラー処理

スクリプトが失敗した場合：

  • GEMINI_API_KEY がエクスポートされているか、~/.nanobanana.env で設定されていることを確認します
  • 入力画像ファイルが存在し、読み取り可能であることを確認します
  • 出力ディレクトリに書き込み権限があることを確認します
  • 画像が生成されない場合は、画像を生成したいことがより明確に伝わるようプロンプトを具体化してください

ベストプラクティス

  1. プロンプトにはスタイル、雰囲気、色、構図などを含め、具体的に記述します
  2. ロゴやグラフィックには、正方形のアスペクト比（1024x1024）を使用します
  3. ソーシャルメディアへの投稿には、ストーリーなら 9:16、投稿なら 1:1 を使用します
  4. 壁紙には、16:9 または 21:9 を使用します
  5. テストでは 1K 解像度から始め、最終出力には 2K／4K に上げます
  6. 最高品質を求める場合は gemini-3-pro-image-preview を、速度を優先する場合は gemini-3.1-flash-image-preview（デフォルト）を使用します

コメント

Markdown 対応