Gemini 3.1 Flash Image Preview (기본값)를 기반으로 하며 Gemini 3 Pro 및 모든 Gemini 모델을 지원하는 AI 이미지 생성 CLI (Command Line Interface)입니다. 다중 해상도 (512-4K), 종횡비 (aspect ratios), 비용 추적, 방송급 그린 스크린 투명도 (green screen transparency), 참조 이미지 (reference images), 그리고 스타일 전이 (style transfer)를 지원합니다.

또한 AI 보조 이미지 생성 워크플로우를 위한 Claude Code 스킬로도 제공됩니다.

요구 사항: Bun, FFmpeg + ImageMagick (투명 모드용)

# 저장소 클론 (Clone the repo)
git clone https://github.com/kingbootoshi/nano-banana-2-skill.git ~/tools/nano-banana-2
cd ~/tools/nano-banana-2
...

Google AI Studio에서 Gemini API 키를 발급받으세요.

이제 어디에서나 nano-banana를 사용할 수 있습니다.

Claude Code 스킬로 설치된 경우, 단순히 /init이라고 말하면 Claude가 저장소를 클론하고, 의존성 (deps)을 설치하며, 명령어를 연결해 줍니다. 그 후 "~의 이미지를 생성해줘"라고 말하면 Claude가 나머지를 처리합니다.

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

# 기본 - 현재 디렉토리에 1K 이미지를 생성합니다
nano-banana "minimal dashboard UI with dark theme"
# 사용자 정의 출력 이름
...

# 기본값 - Nano Banana 2 (Gemini 3.1 Flash, 빠르고 저렴함)
nano-banana "your prompt"
# Pro - 최고 품질, 2배 비용
...

# 와이드스크린 (Widescreen)
nano-banana "cinematic landscape" -a 16:9
# 세로형 (Portrait)
...

지원 항목: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9

기존 이미지를 편집, 변형 또는 결합하세요:

# 기존 이미지 편집
nano-banana "change the background to pure white" -r dark-ui.png -o light-ui
# 스타일 전이 (Style transfer) - 다중 참조
...

AI 기반 배경 제거를 사용하여 투명한 배경을 가진 에셋을 생성하세요:

기본 투명 에셋

nano-banana "robot mascot character" -t -o mascot

투명도가 포함된 로고

...

-t 플래그는 AI가 자동으로 그린 스크린 (green screen)에서 생성하도록 프롬프트를 구성한 뒤, FFmpeg의 colorkey와 despill을 사용하여 배경을 키잉 (key out)하고 가장자리 픽셀에서 녹색 번짐 (green spill)을 제거합니다. ImageMagick이 결과물을 트리밍 (trim)합니다. 필요 사항: brew install ffmpeg imagemagick

마지막 참조 이미지로 빈 이미지를 사용하여 출력 크기를 제어하세요:

# 첫 번째 -r: 스타일 참조 (style reference)
# 마지막 -r: 대상 크기의 빈 이미지
nano-banana "pixel art character, 256x256" -r style.png -r blank-256x256.png -o sprite

모든 생성 작업은 그 비용을 ~/.nano-banana/costs.json에 기록합니다. 지출 내역을 확인하려면:

nano-banana --costs

총 생성 횟수, 총 지출액, 모델별 상세 내역을 보여줍니다.

CLI는 다음 우선순위에 따라 Gemini API 키를 확인합니다:

1. 명령줄의 --api-key 플래그
2. GEMINI_API_KEY 환경 변수
3. 현재 작업 디렉토리의 .env 파일
4. 리포지토리 루트의 .env 파일 (src/ 옆)
5. ~/.nano-banana/.env

Google AI Studio에서 무료 키를 받으세요.

# 옵션 1: 환경 변수 (Environment variable)
export GEMINI_API_KEY=your_key_here
# 옵션 2: 현재 디렉토리의 .env 파일
...

-t 플래그는 픽셀 단위로 완벽한 투명도 (transparency)를 구현하기 위해 3단계 파이프라인을 사용합니다:

그린 스크린 프롬프트 (Green screen prompt) - CLI가 프롬프트에 그린 스크린 지침을 자동으로 추가하여, AI가 단색 녹색 배경 위에서 생성하도록 합니다.
FFmpeg colorkey + despill - colorkey는 녹색 배경을 제거합니다. despill은 RGB 채널에서 녹색 오염을 수학적으로 제거하여 가장자리 픽셀 색상을 재구성합니다. 이것이 가장자리에 녹색 테두리 (green fringe)가 생기지 않고 깔끔하게 처리되는 이유입니다.
자동 크롭 (Auto-crop) - ImageMagick이 투명한 패딩을 트리밍 (trim)하고 캔버스를 재설정합니다.

주요 색상은 모서리 픽셀에서 자동으로 감지됩니다 (AI는 정확한 #00FF00이 아닌 #05F904와 같은 녹색에 가까운 색을 생성합니다). FFmpeg와 ImageMagick이 필요합니다: brew install ffmpeg imagemagick

랜딩 페이지 에셋 (Landing page assets) - 제품 목업 (mockups), UI 미리보기
이미지 편집 (Image editing) - 텍스트 프롬프트로 기존 이미지 변형
스타일 전이 (Style transfer) - 여러 참조 이미지를 결합
마케팅 자료 (Marketing materials) - 히어로 이미지 (hero images), 기능 일러스트레이션
UI 반복 작업 (UI iterations) - 디자인 변형을 빠르게 생성
투명 에셋 (Transparent assets) - 배경이 없는 아이콘, 로고, 마스코트
게임 에셋 (Game assets) - 스프라이트 (sprites), 타일셋 (tilesets), 캐릭터
비디오 제작 (Video production) - Remotion/비디오 구성을 위한 시각적 요소

Claude Code 플러그인으로 설치하면, 다음과 같은 문구에 의해 스킬이 트리거됩니다:

• "generate an image"
• "create a sprite"
• "make an asset"
• "generate artwork"

Claude는 사용자의 요청을 기반으로 적절한 nano-banana 명령어를 구성하며, 모델 선택, 해상도, 종횡비 (aspect ratio), 참조 이미지, 투명도 및 출력 설정을 자동으로 처리합니다.

MIT