All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Pathfinder fork: bearer-authed
GET /images/:storage_id.pngroute on the OAuth sidecar for local downloads. download_urls[]field ingenerate_imagestructured_content(requiresNANOBANANA_PUBLIC_URLenv).NANOBANANA_PUBLIC_URLenv var.
0.4.4 - 2026-03-27
- NB2 thinking support: Send
thinking_levelto Gemini asthinking_configfor NB2 requests - NB2 aspect ratio validation: Allow extreme aspect ratios (
4:1,1:4,8:1,1:8) on the NB2 path - Runtime/test alignment: Update tests to cover NB2 thinking and model-specific aspect ratio behavior
0.3.3 - 2026-01-26
- aspect_ratio support for Pro model: Pass aspect ratio parameter to Gemini API for Pro service (#10)
- output_path support for Pro model: Direct file saving with automatic thumbnail generation (#10)
- Input validation: Add aspect_ratio validation before API calls to prevent invalid requests
- Error handling: Graceful degradation when thumbnail creation fails (returns full image instead)
- Code quality: Fix datetime timezone awareness (DTZ005) and hashlib security parameter (S324)
- @paulrobello (#10)
0.3.2 - 2026-01-17
- API compatibility: Remove unsupported
output_mime_typeparameter fromImageConfig(#11) - Dependency version: Bump
google-genairequirement from>=1.41.0to>=1.57.0to ensureimage_sizeparameter support (#12) - Test coverage: Update test expectations after
output_mime_typeremoval
ImageConfigis now only created when there are actual parameters to configure (aspect_ratio or resolution)
- @georgesung (#13)
0.3.1 - 2026-01-08
- output_path parameter: Control where generated images are saved (#8)
- Exact file path mode:
/path/to/image.png - Directory mode:
/path/to/dir/ - Default fallback:
IMAGE_OUTPUT_DIRor~/nanobanana-images
- Exact file path mode:
- Pro model routing: Fix critical bug where Pro model requests were always routed to Flash service (#9)
- API parameters: Remove unsupported
thinking_levelparameter from gemini-3-pro-image-preview - Response modalities: Change from
["Image"]to["TEXT", "IMAGE"]for Pro model compatibility - Default region: Change default GCP region to
globalfor Pro model support
- @jgeewax
- @akshayvkt
0.3.0 - 2026-01-06
- Nano Banana Pro Integration: Support for Gemini 3 Pro Image model
- 4K resolution support (up to 3840px)
- Google Search grounding for factual accuracy
- Configurable thinking levels (LOW/HIGH)
- Media resolution control
- Intelligent Model Selection: Automatic routing between Flash and Pro models
ModelSelectorservice for smart model routing- Quality/speed keyword detection
- Resolution-based selection
- ADC Authentication: Application Default Credentials support for Vertex AI (#6)
- Multi-tier configuration system:
ModelSelectionConfig,ProImageConfig ProImageServicefor dedicated Gemini 3 Pro Image operations
0.2.0 - 2026-01-03
- Initial production-ready release
- Gemini 2.5 Flash Image support
- FastMCP framework integration
- Image generation and editing tools
- Aspect ratio validation
- Comprehensive test coverage
- MIT License