Nano Banana 2 Skill
Консольная утилита и скилл для Claude Code: картинки через Gemini от 512 до 4K, правка по образцам, прозрачные ассеты
- 416 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Каждая генерация идет в Gemini API по вашему ключу и тратит ваши деньги
- Установка через `/init` клонирует репозиторий, ставит зависимости и записывает ключ в `~/.nano-banana/.env`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/nano-banana-2-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Каждая генерация идет в Gemini API по вашему ключу и тратит ваши деньги
- Установка через `/init` клонирует репозиторий, ставит зависимости и записывает ключ в `~/.nano-banana/.env`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
nano-banana — консольная утилита на Bun, которая генерирует картинки через Gemini API и подключается к Claude Code как скилл. По умолчанию она берет Gemini 3.1 Flash Image Preview (он же Nano Banana 2), а Gemini 3 Pro Image Preview включается флагом `--model pro`. Доступны размеры от 512 до 4K, десять соотношений сторон от 1:1 до 21:9 и вывод в выбранную папку. Исходные картинки передаются флагом `-r`, можно несколько сразу: так делают правку, смену фона и перенос стиля. Для прозрачных ассетов флаг `-t` просит модель нарисовать объект на зеленом фоне, затем FFmpeg убирает цвет и зеленую кайму, а ImageMagick обрезает поля. Точный размер задается пустой картинкой нужного размера в пикселях, добавленной последним образцом. Каждая генерация пишет стоимость в `~/.nano-banana/costs.json`, а команда `nano-banana --costs` показывает общие траты и разбивку по моделям. Когда плагин установлен, Claude собирает команду сам по фразам вроде «generate an image» или «create a sprite» и выбирает модель, размер, соотношение сторон и образцы.
Для кого. Для разработчиков, дизайнеров и авторов игр, которым нужны иллюстрации, макеты и спрайты из терминала или прямо из диалога с Claude Code.
Подходит, если
- Нужны иллюстрации и макеты для лендинга, карточек или презентации, и вы хотите получать их из терминала
- Требуется спрайт, иконка или логотип на прозрачном фоне: флаг `-t` убирает зеленый фон
- Есть готовая картинка, которую надо поправить текстом или привести к стилю другой: флаг `-r` с одним или несколькими образцами
- Хочется видеть расходы на картинки: `nano-banana --costs` суммирует журнал генераций
- Нужны визуальные элементы для видеокомпозиций, например на Remotion
Не подходит, если
- Нет ключа Gemini API или доступа к Google AI Studio: без них утилита не запускается
- Нельзя ставить Bun, а для режима `-t` еще FFmpeg и ImageMagick
- Нужна генерация без трат: картинка 1K на Flash оценивается примерно в 0,067 доллара, на Pro вдвое дороже
- Нужны анимация или видео: утилита делает только статичные изображения
Пример запроса к агенту
Сгенерируй логотип робота-лисы на прозрачном фоне в 2K и сохрани в папку `assets` под именем `fox-logo`Ограничения
- Gemini API из России недоступен, и без доступа к нему утилита не заработает. Нужен ключ Gemini API из Google AI Studio. - Нужен Bun. Для режима `-t` еще FFmpeg и ImageMagick, на macOS их ставит `brew install ffmpeg imagemagick`. - Обе модели названы превью-версиями, а цены в таблице автора приблизительные. - Цвет фона в режиме `-t` определяется по угловым пикселям, потому что модель рисует близкий к зеленому оттенок вроде `#05F904`. -
Как отключить. Уберите плагин командами `/plugin` в Claude Code. Саму утилиту удалите вместе с папкой `~/tools/nano-banana-2` и ссылкой на команду nano-banana, которую создал `bun link`. Ключ и журнал расходов лежат в ~/.nano-banana/.
Частые вопросы
Как поставить Nano Banana 2 Skill в Claude Code?
Выполните `/plugin marketplace add kingbootoshi/nano-banana-2-skill` и `/plugin install nano-banana@nano-banana-2-skill-marketplace`. Затем скажите `/init`: Claude клонирует репозиторий в `~/tools/nano-banana-2`, поставит зависимости, свяжет команду nano-banana и спросит ключ Gemini.
Какая модель используется по умолчанию и как включить Pro?
По умолчанию работает Gemini 3.1 Flash Image Preview под псевдонимами `flash` и `nb2`. Флаг `--model pro` включает Gemini 3 Pro Image Preview, а в `--model` можно передать и любой другой идентификатор модели, например `gemini-2.5-flash-image`.
Как получить картинку с прозрачным фоном?
Добавьте флаг `-t`, например `nano-banana "pixel art treasure chest" -t -o chest`. Утилита просит модель нарисовать объект на зеленом фоне, FFmpeg вырезает цвет и убирает зеленую кайму, ImageMagick обрезает прозрачные поля.
Сколько стоит генерация?
По таблице автора на Flash картинка 512 стоит около 0,045 доллара, 1K около 0,067, 2K около 0,101, 4K около 0,151. На Pro 1K обходится примерно в 0,134. Журнал лежит в `~/.nano-banana/costs.json`, сумму показывает `nano-banana --costs`.
Откуда утилита берет ключ Gemini?
В таком порядке: флаг `--api-key`, переменная окружения `GEMINI_API_KEY`, файл `.env` в текущей папке, файл `.env` рядом с исходниками, затем `~/.nano-banana/.env`. Ключ выдает Google AI Studio.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл генерации, правки и ревью изображений в Claude Code через модели Google Gemini, с планом и подтверждением перед каждым платным запросом
MCP-сервер генерации и правки картинок моделями Gemini: сам выбирает модель под запрос, рисует до 4K в нужном формате кадра
Скилл для Claude Code, который превращает документ в слайды-картинки через Gemini и собирает видео с переходами Kling AI
Nano Banana Pro Prompts Recommend
AI Image Prompt Recommender
Скилл подбирает готовые промпты для генерации картинок из большой библиотеки, показывает примеры изображений и собирает промпт под ваш текст
Более 1400 популярных промптов для NanoBanana и GPT Image из постов в X с рейтингом по лайкам и системный промпт, который улучшает короткую идею
Nano Banana Pro Prompts от YouMind
awesome-nano-banana-pro-prompts
Крупная библиотека промптов для Nano Banana Pro: по данным автора, более 10 тысяч промптов с примерами, источниками и веб-галереей
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Nano Banana 2 Skill (эта запись) | нет | 416 | ||
| Banana Claude | нет | 1 148 | скилл на моделях Gemini с планом и подтверждением перед каждым платным запросом | |
| gflow-cli | нет | 347 | консольный клиент и MCP-сервер Google Flow для видео Veo и картинок Imagen | |
| Nano Banana MCP Server | нет | API-ключ | 402 | MCP-сервер генерации и правки картинок моделями Gemini |
Коротко о README
Описание начинается с установки через Bun, затем идут примеры по режимам: модели, соотношения сторон, образцы, прозрачность и точные размеры. Дальше таблицы параметров и цен, порядок поиска ключа и список сценариев применения.
Бейдж для README
Исходный SKILL.md
---
name: nano-banana
description: Generates AI images using the nano-banana CLI (Gemini 3.1 Flash default, Pro available). Handles multi-resolution (512-4K), aspect ratios, reference images for style transfer, green screen workflow for transparent assets, cost tracking, and exact dimension control. Use when asked to "generate an image", "create a sprite", "make an asset", "generate artwork", or any image generation task for UI mockups, game assets, videos, or marketing materials.
---
# nano-banana
AI image generation CLI. Default model: Gemini 3.1 Flash Image Preview (Nano Banana 2).
## /init - First-Time Setup
When the user says "init", "setup nano-banana", or "install nano-banana", run these commands to get the CLI tool on their machine. No sudo required.
**Prerequisites:** Bun must be installed. If not: `curl -fsSL https://bun.sh/install | bash`
```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
```
After init, the user can type `nano-banana "prompt"` from anywhere.
If `bun link` fails or the command is not found after linking, fall back to:
```bash
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
```
Get a Gemini API key at: https://aistudio.google.com/apikey
## Quick Reference
- Command: `nano-banana "prompt" [options]`
- Default: 1K resolution, Flash model, current directory
## Core Options
| Option | Default | Description |
|--------|---------|-------------|
| `-o, --output` | `nano-gen-{timestamp}` | Output filename (no extension) |
| `-s, --size` | `1K` | Image size: `512`, `1K`, `2K`, or `4K` |
| `-a, --aspect` | model default | Aspect ratio: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, etc. |