geoai-py 0.21.0__tar.gz → 0.22.0__tar.gz

{geoai_py-0.21.0 → geoai_py-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.21.0
+Version: 0.22.0
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -70,6 +70,7 @@ Dynamic: license-file
 [![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/conda-forge/geoai-py-feedstock)
 [![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![image](https://img.shields.io/badge/YouTube-Tutorials-red)](https://tinyurl.com/GeoAI-Tutorials)
+[![QGIS](https://img.shields.io/badge/QGIS-plugin-orange.svg)](https://opengeoai.org/qgis_plugin)
 
 [![logo](https://raw.githubusercontent.com/opengeos/geoai/master/docs/assets/logo_rect.png)](https://github.com/opengeos/geoai/blob/master/docs/assets/logo.png)
 
@@ -166,7 +167,7 @@ mamba install -c conda-forge geoai
 
 Check out the [QGIS Plugin](https://opengeoai.org/qgis_plugin/) page if you are interested in using GeoAI with QGIS.
 
-[![demo](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)
+[![demo](https://github.com/user-attachments/assets/5aabc3d3-efd1-4011-ab31-2b3f11aab3ed)](https://youtu.be/8-OhlqeoyiY)
 
 ## 📋 Documentation
 

{geoai_py-0.21.0 → geoai_py-0.22.0}/README.md

@@ -7,6 +7,7 @@
 [![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/conda-forge/geoai-py-feedstock)
 [![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![image](https://img.shields.io/badge/YouTube-Tutorials-red)](https://tinyurl.com/GeoAI-Tutorials)
+[![QGIS](https://img.shields.io/badge/QGIS-plugin-orange.svg)](https://opengeoai.org/qgis_plugin)
 
 [![logo](https://raw.githubusercontent.com/opengeos/geoai/master/docs/assets/logo_rect.png)](https://github.com/opengeos/geoai/blob/master/docs/assets/logo.png)
 
@@ -103,7 +104,7 @@ mamba install -c conda-forge geoai
 
 Check out the [QGIS Plugin](https://opengeoai.org/qgis_plugin/) page if you are interested in using GeoAI with QGIS.
 
-[![demo](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)
+[![demo](https://github.com/user-attachments/assets/5aabc3d3-efd1-4011-ab31-2b3f11aab3ed)](https://youtu.be/8-OhlqeoyiY)
 
 ## 📋 Documentation
 

{geoai_py-0.21.0 → geoai_py-0.22.0}/geoai/__init__.py

@@ -2,7 +2,7 @@
 
 __author__ = """Qiusheng Wu"""
 __email__ = "giswqs@gmail.com"
-__version__ = "0.21.0"
+__version__ = "0.22.0"
 
 
 import os

{geoai_py-0.21.0 → geoai_py-0.22.0}/geoai_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geoai-py
-Version: 0.21.0
+Version: 0.22.0
 Summary: A Python package for using Artificial Intelligence (AI) with geospatial data
 Author-email: Qiusheng Wu <giswqs@gmail.com>
 License: MIT License
@@ -70,6 +70,7 @@ Dynamic: license-file
 [![Conda Recipe](https://img.shields.io/badge/recipe-geoai-green.svg)](https://github.com/conda-forge/geoai-py-feedstock)
 [![image](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![image](https://img.shields.io/badge/YouTube-Tutorials-red)](https://tinyurl.com/GeoAI-Tutorials)
+[![QGIS](https://img.shields.io/badge/QGIS-plugin-orange.svg)](https://opengeoai.org/qgis_plugin)
 
 [![logo](https://raw.githubusercontent.com/opengeos/geoai/master/docs/assets/logo_rect.png)](https://github.com/opengeos/geoai/blob/master/docs/assets/logo.png)
 
@@ -166,7 +167,7 @@ mamba install -c conda-forge geoai
 
 Check out the [QGIS Plugin](https://opengeoai.org/qgis_plugin/) page if you are interested in using GeoAI with QGIS.
 
-[![demo](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)
+[![demo](https://github.com/user-attachments/assets/5aabc3d3-efd1-4011-ab31-2b3f11aab3ed)](https://youtu.be/8-OhlqeoyiY)
 
 ## 📋 Documentation
 

{geoai_py-0.21.0 → geoai_py-0.22.0}/geoai_py.egg-info/SOURCES.txt

@@ -63,6 +63,7 @@ qgis_plugin/geoai_plugin/dialogs/map_tools.py
 qgis_plugin/geoai_plugin/dialogs/moondream.py
 qgis_plugin/geoai_plugin/dialogs/samgeo.py
 qgis_plugin/geoai_plugin/dialogs/segmentation.py
+qgis_plugin/geoai_plugin/dialogs/update_checker.py
 qgis_plugin/geoai_plugin/icons/about.svg
 qgis_plugin/geoai_plugin/icons/gpu.svg
 qgis_plugin/geoai_plugin/icons/icon.png

{geoai_py-0.21.0 → geoai_py-0.22.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "geoai-py"
-version = "0.21.0"
+version = "0.22.0"
 dynamic = [
     "dependencies",
 ]
@@ -45,7 +45,7 @@ universal = true
 
 
 [tool.bumpversion]
-current_version = "0.21.0"
+current_version = "0.22.0"
 commit = true
 tag = true
 

{geoai_py-0.21.0 → geoai_py-0.22.0}/qgis_plugin/README.md

@@ -1,14 +1,26 @@
 # QGIS Plugin for GeoAI
 
-A QGIS plugin providing AI-powered geospatial analysis tools from the [geoai](https://github.com/opengeos/geoai) package. The plugin bundles several model-driven workflows (Moondream VLM, segmentation training/inference, SamGeo) into dockable panels so you can keep QGIS as the main workspace while experimenting with GeoAI.
+A QGIS plugin that brings the [geoai](https://github.com/opengeos/geoai) models into dockable panels (Moondream VLM, segmentation training/inference, SamGeo) so you can keep QGIS as your main workspace while experimenting with GeoAI.
 
 ## Quick Start
 
-1. Create a fresh conda environment (`conda create -n geo python=3.12`) and install QGIS plus GeoAI dependencies as described below.
-2. Install the GeoAI QGIS plugin either from the script (`python install.py`) or by copying the `qgis_plugin` folder into your QGIS profile.
-3. Restart QGIS, enable the plugin under `Plugins` → `Manage and Install Plugins...`, and open one of the panels from the GeoAI toolbar to begin experimenting with sample datasets.
+-   Create a fresh conda env (`conda create -n geo python=3.12`) and install QGIS + deps (see below).
+-   Install the plugin (`python install.py`) from this repo.
+-   Restart QGIS → `Plugins` → `Manage and Install Plugins...` → enable `GeoAI`.
+-   Open a GeoAI toolbar panel and try the sample datasets below.
 
-[![demo](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)](https://github.com/user-attachments/assets/557feb58-ca58-4e27-800f-f3e8a8d3d362)
+## Video Tutorials
+
+Check out this [short video demo](https://youtu.be/Esr_e6_P1is) and [full video tutorial](https://youtu.be/8-OhlqeoyiY) on how to use the GeoAI plugin in QGIS.
+
+[![demo](https://github.com/user-attachments/assets/5aabc3d3-efd1-4011-ab31-2b3f11aab3ed)](https://youtu.be/8-OhlqeoyiY)
+
+## Requirements
+
+-   QGIS 3.28 or later
+-   Python 3.10+ (conda recommended)
+-   PyTorch (CUDA if you want GPU acceleration)
+-   `geoai` and `samgeo` packages
 
 ## Features
 
@@ -39,85 +51,97 @@ Each tool lives inside a dockable panel that can be attached to either side of t
 
 -   **Clear GPU Memory**: Release GPU memory and clear CUDA cache for all loaded models
 
-## Requirements
-
--   QGIS 3.28 or later
--   Python 3.10+
--   PyTorch (with CUDA support for GPU acceleration)
--   geoai-py package
--   samgeo package (for SamGeo panel)
-
 ## Installation
 
-### Install QGIS and Python Packages
+### 1) Set up the environment
 
-Before using the plugin, create a new conda environment dedicated to QGIS and the Python dependencies. Please do not try to reuse an existing QGIS install—mismatched Python packages almost always break the plugin.
+#### Installation on Linux/macOS
 
-It is recommended to use [Miniconda](https://www.anaconda.com/docs/getting-started/miniconda/install) to manage conda environments. Once Miniconda is installed, open the Terminal or Anaconda Prompt and run the following commands to create a new conda environment and install QGIS and Python packages:
+Use a clean conda env dedicated to QGIS—mixing with an existing QGIS install often breaks dependencies.
 
 ```bash
 conda create -n geo python=3.12
 conda activate geo
-conda install -c conda-forge qgis segment-geospatial geoai
 ```
 
-Some SamGeo dependencies are only available on PyPI. Run the following command to install the remaining dependencies:
+Install core geospatial deps first:
 
 ```bash
-pip install -U "segment-geospatial[samgeo3]"
+conda install -c conda-forge --strict-channel-priority gdal rasterio libnetcdf netcdf4
+python -c "import rasterio; print('rasterio import successful')"
 ```
 
-It is a bit trickier to install SAM 3 on Windows. Use the following commands to prepare the environment:
+Install GeoAI:
 
 ```bash
-conda create -n geo python=3.12
-conda activate geo
-conda install pytorch torchvision pytorch-cuda=12.1 -c pytorch -c nvidia
-conda install -c conda-forge qgis segment-geospatial geoai
-pip install "segment-geospatial[samgeo3]" triton-windows
+conda install -c conda-forge geoai
+python -c "import geoai; print('geoai import successful')"
+```
+
+Install QGIS:
+
+```bash
+conda install -c conda-forge qgis
+```
+
+Install SamGeo extras (PyPI is required for some parts):
+
+```bash
+pip install -U "segment-geospatial[samgeo3]" sam3
+python -c "import samgeo; print('samgeo import successful')"
 ```
 
-### Install QGIS Plugin
+#### Installation on Windows
 
-### Option 1: Install from Plugin Manager (Coming soon)
+Windows + SAM3 often needs the PyTorch wheels from NVIDIA and PyPI:
 
-1. Open QGIS
-2. Go to `Plugins` → `Manage and Install Plugins...`
-3. Search for "GeoAI"
-4. Click "Install Plugin"
+```bash
+conda create -n geo python=3.12
+conda activate geo
+conda install pytorch torchvision pytorch-cuda=12.1 -c pytorch -c nvidia
+conda install -c conda-forge geoai
+python -c "import geoai; print('geoai import successful')"
+conda install -c conda-forge qgis
+pip install -U "segment-geospatial[samgeo3]" triton-windows
+pip install -U sam3 geoai
+```
 
-### Option 2: Install Using Script
+#### Request access to SAM 3
 
-1. Clone or download this repository
+To use SAM 3, you will need to request access by filling out this form on Hugging Face at <https://huggingface.co/facebook/sam3>. Once your request has been approved, run the following command in the terminal to authenticate:
 
-    ```bash
-    git clone https://github.com/opengeos/geoai.git
-    ```
+```bash
+hf auth login
+```
 
-2. Run the installation script (from the repo root it will link/copy files to your QGIS profile):
+### 2) Install the QGIS plugin
 
-    ```bash
-    cd qgis_plugin
-    python install.py
-    ```
+Option A — use the helper script (recommended):
 
-3. Restart QGIS so it picks up the new plugin files.
-4. Enable the plugin in `Plugins` → `Manage and Install Plugins...` → Toggle on the `GeoAI` plugin.
+```bash
+git clone https://github.com/opengeos/geoai.git
+cd geoai/qgis_plugin
+python install.py
+```
 
-To remove the plugin:
+This links/copies the plugin into your active QGIS profile. Re-run after pulling updates. Remove with:
 
 ```bash
 python install.py --remove
 ```
 
-### Option 3: Manual Installation
+Option B — manual copy:
+
+-   Copy the `qgis_plugin` folder to your QGIS plugins directory:
+    -   Linux: `~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/`
+    -   Windows: `C:\Users\<username>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\`
+    -   macOS: `~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/`
+
+### 3) Enable in QGIS
 
-1. Copy the `qgis_plugin` folder to your QGIS plugins directory:
-    - **Linux**: `~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/`
-    - **Windows**: `C:\Users\<username>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\`
-    - **macOS**: `~/Library/Application Support/QGIS/QGIS3/profiles/default/python/plugins/`
-2. Restart QGIS
-3. Enable the plugin in `Plugins` → `Manage and Install Plugins...` → Toggle on the `GeoAI` plugin. Revisit this dialog any time you update the plugin files.
+Launch QGIS: `conda run qgis`
+
+QGIS → `Plugins` → `Manage and Install Plugins...` → enable `GeoAI`. After updates, toggle the plugin off/on or restart QGIS to reload.
 
 ## Usage
 
@@ -144,9 +168,9 @@ Steps:
 
 Sample datasets:
 
--   [naip_train_buildings.tif](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train_buildings.tif)
--   [naip_test_buildings.tif](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_test_buildings.tif)
--   [naip_test_buildings.geojson](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_test_buildings.geojson)
+-   [naip_rgb_train.tif](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_rgb_train.tif)
+-   [naip_test.tif](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_test.tif)
+-   [naip_train_buildings.geojson](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/naip_train_buildings.geojson)
 
 Steps:
 
@@ -166,7 +190,12 @@ Steps:
 
 ### SamGeo Panel (Segment Anything Model)
 
-Sample dataset: [uc_berkeley.tif](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/uc_berkeley.tif)
+Sample dataset:
+
+-   [uc_berkeley.tif](https://huggingface.co/datasets/giswqs/geospatial/resolve/main/uc_berkeley.tif)
+-   [wa_building_image.tif](https://github.com/opengeos/datasets/releases/download/places/wa_building_image.tif)
+-   [wa_building_centroids.geojson](https://github.com/opengeos/datasets/releases/download/places/wa_building_centroids.geojson)
+-   [wa_building_bboxes.geojson](https://github.com/opengeos/datasets/releases/download/places/wa_building_bboxes.geojson)
 
 Steps:
 
@@ -244,6 +273,13 @@ The QGIS plugin supports any models supported by [Pytorch Segmentation Models](h
 -   **SamGeo2 (SAM2)**: Improved version with better performance
 -   **SamGeo (SAM1)**: Original Segment Anything Model
 
+## Troubleshooting
+
+-   Plugin missing after install: confirm the plugin folder exists in your QGIS profile path and that you restarted QGIS.
+-   GDAL/rasterio errors: verify you launched QGIS from the conda env (`conda activate geo` then `qgis`) so it picks up the same Python libs.
+-   CUDA OOM: use the **GPU** button to clear cache, lower batch sizes, or switch to CPU for smaller runs.
+-   Model download failures: check network/firewall, then retry loading models from the panel.
+
 ## License
 
 MIT License - see [LICENSE](../LICENSE) for details.

{geoai_py-0.21.0 → geoai_py-0.22.0}/qgis_plugin/geoai_plugin/dialogs/__init__.py

@@ -6,8 +6,10 @@ This module contains the dialog and dock widget classes for the GeoAI plugin.
 
 from .moondream import MoondreamDockWidget
 from .segmentation import SegmentationDockWidget
+from .update_checker import UpdateCheckerDialog
 
 __all__ = [
     "MoondreamDockWidget",
     "SegmentationDockWidget",
+    "UpdateCheckerDialog",
 ]