Repository navigation
Geo-SAM v2.0
A ground-up rewrite of the Geo-SAM QGIS plugin, built on the new geosam core library with the Ultralytics SAM backend.
🏗️ Architecture
- Full backend rewrite — replaced in-plugin SAM implementation with the
geosamcore library - SAM backend switched to Ultralytics — model loading and inference now use the ultralytics SAM stack
- Plugin-managed dependencies & models — one-click install/download, no manual
pipor file management
✨ New Features
- Live Encoding mode — segment directly from a raster layer without pre-encoding; features are encoded on the fly via QGIS background tasks and cached for fast re-queries
- Pre-encoded mode — use Image Encoder to generate reusable feature files for repeated segmentation of the same image
- Online tile layer support — XYZ, WMS, and WMTS tile layers can be used in live-encoding mode (supports arbitrary WMTS CRS)
- SAM2 and SAM3 model support — added SAM2, SAM2.1, and SAM3 model families alongside the original SAM
- Vectorization mode — choose between Pixel-Level and Simplified polygon output
- Max Polygon Only mode — keep only the largest polygon from the current mask
- Unified Settings dialog — four tabs (Dependencies, Model Management, Cache, Help)
- In-app Model Management — download, delete, and unload SAM checkpoints with Ultralytics + ModelScope fallback
- Feature cache management — configurable cache directory, maximum size, performance mode (Balanced / Fastest / Low Memory)
- Split-panel UI — Segmentation dock widget with Input/Output + Prompts on the left, Styles + Options on the right
- Multi-language UI — 中文, 日本語, 한국어, Français, Русский, العربية, Deutsch, Español, Português
- Selectable realtime performance modes and async preview pipeline
🔧 Improvements
- PyQt6 / QGIS 4 compatibility
- Faster prompt response via feature cache reuse
- Better memory management (Balanced vs Low Memory strategies)
- Preserved polygon holes when saving SAM results
- Tab key cycles prompt types; keyboard shortcuts work even when widget is not focused
- Preview Mode — SAM predictions follow the mouse cursor in real time
- Lazy-load Geo-SAM runtime dependencies for faster plugin startup
- Improved dependency settings UI with install progress feedback
- Backend abstraction layer for QGIS integration
🗑️ Removed
torchgeoandsegment_anythingas runtime dependencies (replaced bygeosam+ultralytics)- Minimum Pixels parameter from the Segmentation tool UI
- Load Demo option
- Manual pip dependency installation (replaced by Settings dialog)
🐛 Bug Fixes
- Fixed polygon holes not preserved when saving SAM results
- Fixed SAM3 model image size handling
- Fixed preview mode defaults and setting changes not persisting
- Fixed online raster cache reuse across models
- Fixed Windows QGIS Python interpreter resolution for dependency install
- Fixed Conda QGIS runtime missing rasterio, geopandas, shapely, pyproj
- Fixed crash on open widget due to tab key looping
- Fixed second point not working in prompt
- Fixed CRS comparison issues in realtime cache
- Fixed
user.jsoncreation when file doesn't exist
📦 Dependencies
- New:
geosamcore library - New:
ultralyticsfor SAM model inference - Removed:
torchgeo,segment_anything
Full Changelog: v1.3.2...v2.0