nanobanana by resciencelab/opc-skills
npx skills add https://github.com/resciencelab/opc-skills --skill nanobanana使用 Google 的 Gemini 3 Pro Image 模型(gemini-3-pro-image-preview,昵称 "Nano Banana Pro" 🍌)生成和编辑图像。
必需项:
GEMINI_API_KEY - 从 Google AI Studio 获取google-genai 包安装依赖:
pip install google-genai pillow
python3 <skill_dir>/scripts/generate.py "一个可爱的机器人吉祥物,像素艺术风格" -o robot.png
python3 <skill_dir>/scripts/generate.py "把背景变成蓝色" -i input.jpg -o output.png
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
python3 <skill_dir>/scripts/generate.py "电影级风景" --ratio 21:9 -o landscape.png
python3 <skill_dir>/scripts/generate.py "专业产品照片" --size 4K -o product.png
scripts/generate.py主要的图像生成脚本。
Usage: generate.py [OPTIONS] PROMPT
Arguments:
PROMPT 图像生成的文本提示
Options:
-o, --output PATH 输出文件路径(默认:自动生成)
-i, --input PATH 用于编辑的输入图像(可选)
-r, --ratio RATIO 宽高比(1:1, 16:9, 9:16, 21:9 等)
-s, --size SIZE 图像尺寸:2K 或 4K(默认:标准)
--search 启用 Google 搜索基础以提升准确性
-v, --verbose 显示详细输出
支持的宽高比:
1:1 - 正方形(默认)2:3, 3:2 - 纵向/横向3:4, 4:3 - 标准4:5, 5:4 - 照片9:16, 16:9 - 宽屏21:9 - 超宽屏/电影比例scripts/batch_generate.py生成多个图像并使用顺序命名。
Usage: batch_generate.py [OPTIONS] PROMPT
Arguments:
PROMPT 图像生成的文本提示
Options:
-n, --count N 要生成的图像数量(默认:10)
-d, --dir PATH 输出目录
-p, --prefix STR 文件名前缀(默认:"image")
-r, --ratio RATIO 宽高比
-s, --size SIZE 图像尺寸(2K/4K)
--delay SECONDS 生成间隔延迟(默认:3)
示例:
python3 <skill_dir>/scripts/batch_generate.py "像素艺术标志" -n 20 -d ./logos -p logo
你也可以直接使用模块:
from generate import generate_image, edit_image
# 生成图像
result = generate_image(
prompt="夜晚的未来城市",
output_path="city.png",
aspect_ratio="16:9",
image_size="4K"
)
# 编辑现有图像
result = edit_image(
prompt="在天空中添加飞行汽车",
input_path="city.png",
output_path="city_edited.png"
)
| 变量 | 描述 | 默认值 |
|---|---|---|
GEMINI_API_KEY | Google Gemini API 密钥 | 必需 |
IMAGE_OUTPUT_DIR | 默认输出目录 | ./nanobanana-images |
根据文本描述创建图像。该模型擅长:
使用自然语言转换现有图像:
启用 --search 以获取涉及以下内容的、事实准确的图像:
好的提示词包含:
示例:
"一个舒适的咖啡馆内部,温暖的灯光,复古美学,
木制家具,架子上的植物,早晨阳光透过窗户,
背景柔焦,35mm 胶片摄影风格"
"未找到 API 密钥"
GEMINI_API_KEY 环境变量--api-key 选项传递"响应中没有图像"
"超出速率限制"
每周安装量
1.2K
仓库
GitHub 星标
628
首次出现
2026年1月21日
安全审计
安装于
opencode967
gemini-cli961
codex950
github-copilot902
cursor886
claude-code857
Generate and edit images using Google's Gemini 3 Pro Image model (gemini-3-pro-image-preview, nicknamed "Nano Banana Pro" 🍌).
Required:
GEMINI_API_KEY - Get from Google AI Studiogoogle-genai packageInstall dependencies:
pip install google-genai pillow
python3 <skill_dir>/scripts/generate.py "a cute robot mascot, pixel art style" -o robot.png
python3 <skill_dir>/scripts/generate.py "make the background blue" -i input.jpg -o output.png
python3 <skill_dir>/scripts/generate.py "cinematic landscape" --ratio 21:9 -o landscape.png
python3 <skill_dir>/scripts/generate.py "professional product photo" --size 4K -o product.png
scripts/generate.pyMain image generation script.
Usage: generate.py [OPTIONS] PROMPT
Arguments:
PROMPT Text prompt for image generation
Options:
-o, --output PATH Output file path (default: auto-generated)
-i, --input PATH Input image for editing (optional)
-r, --ratio RATIO Aspect ratio (1:1, 16:9, 9:16, 21:9, etc.)
-s, --size SIZE Image size: 2K or 4K (default: standard)
--search Enable Google Search grounding for accuracy
-v, --verbose Show detailed output
Supported aspect ratios:
1:1 - Square (default)2:3, 3:2 - Portrait/Landscape3:4, 4:3 - Standard4:5, 5:4 - Photo9:16, 16:9 - Widescreen21:9 - Ultra-wide/Cinematicscripts/batch_generate.pyGenerate multiple images with sequential naming.
Usage: batch_generate.py [OPTIONS] PROMPT
Arguments:
PROMPT Text prompt for image generation
Options:
-n, --count N Number of images to generate (default: 10)
-d, --dir PATH Output directory
-p, --prefix STR Filename prefix (default: "image")
-r, --ratio RATIO Aspect ratio
-s, --size SIZE Image size (2K/4K)
--delay SECONDS Delay between generations (default: 3)
Example:
python3 <skill_dir>/scripts/batch_generate.py "pixel art logo" -n 20 -d ./logos -p logo
You can also use the module directly:
from generate import generate_image, edit_image
# Generate image
result = generate_image(
prompt="a futuristic city at night",
output_path="city.png",
aspect_ratio="16:9",
image_size="4K"
)
# Edit existing image
result = edit_image(
prompt="add flying cars to the sky",
input_path="city.png",
output_path="city_edited.png"
)
| Variable | Description | Default |
|---|---|---|
GEMINI_API_KEY | Google Gemini API key | Required |
IMAGE_OUTPUT_DIR | Default output directory | ./nanobanana-images |
Create images from text descriptions. The model excels at:
Transform existing images with natural language:
Enable --search for factually accurate images involving:
Good prompts include:
Example:
"A cozy coffee shop interior, warm lighting, vintage aesthetic,
wooden furniture, plants on shelves, morning sunlight through windows,
soft focus background, 35mm film photography style"
"API key not found"
GEMINI_API_KEY environment variable--api-key option"No image in response"
"Rate limit exceeded"
Weekly Installs
1.2K
Repository
GitHub Stars
628
First Seen
Jan 21, 2026
Security Audits
Gen Agent Trust HubFailSocketPassSnykPass
Installed on
opencode967
gemini-cli961
codex950
github-copilot902
cursor886
claude-code857
React 组合模式指南:Vercel 组件架构最佳实践,提升代码可维护性
102,200 周安装