descriptron-gui 2.3.0__tar.gz → 2.5.2__tar.gz

{descriptron_gui-2.3.0 → descriptron_gui-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: descriptron-gui
-Version: 2.3.0
+Version: 2.5.2
 Summary: The Descriptron annotation GUI: SAM2-assisted segmentation, keypoints and COCO export
 Project-URL: Homepage, https://github.com/alexrvandam/Descriptron
 Author: Alex R. Van Dam
@@ -14,8 +14,9 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Scientific/Engineering :: Image Processing
 Requires-Python: >=3.9
-Requires-Dist: descriptron-core==2.3.0
-Requires-Dist: descriptron-vision==2.3.0
+Requires-Dist: descriptron-core==2.5.2
+Requires-Dist: descriptron-vision==2.5.2
+Requires-Dist: tkinterdnd2>=0.4
 Requires-Dist: tkmacosx>=1.0.5; sys_platform == 'darwin'
 Provides-Extra: dev
 Requires-Dist: build>=1; extra == 'dev'
@@ -29,10 +30,16 @@ The [Descriptron](https://github.com/alexrvandam/Descriptron) annotation GUI:
 SAM2-assisted segmentation, keypoints, line annotations and COCO export.
 
 ```bash
+SAM2_BUILD_CUDA=0 pip install git+https://github.com/facebookresearch/sam2.git   # SAM2 library, not on PyPI (Windows: set SAM2_BUILD_CUDA=0 first)
 pip install descriptron-gui
-descriptron-gui
+descriptron-gui          # first start downloads the SAM2 model file (898 MB) into ~/.cache/descriptron/sam2/
 ```
 
+SAM2 must be installed from Meta's GitHub into the same environment (PyPI does not allow it as a dependency). If you
+already have `sam2_hiera_large.pt`, copy it to `~/.cache/descriptron/sam2/` or set `DESCRIPTRON_SAM2_CHECKPOINT`
+to its path. Step by step for Windows, macOS and Linux:
+https://github.com/alexrvandam/Descriptron/blob/main/docs/INSTALL_PIP.md
+
 Pulls in `descriptron-core` and `descriptron-vision`: the GUI drives the analysis
 programs directly, so it is not a thin front end over them.
 
@@ -44,4 +51,5 @@ sudo apt install python3-tk      # Debian/Ubuntu
 sudo dnf install python3-tkinter # Fedora/RHEL
 ```
 
-Model weights are not bundled; they download on first use and are cached.
+Model weights are not bundled; they download on first use and are cached. Drag an image or a folder onto the
+window, or start with one: `descriptron-gui path/to/images`.

descriptron_gui-2.5.2/README.md

@@ -0,0 +1,29 @@
+# descriptron-gui
+
+The [Descriptron](https://github.com/alexrvandam/Descriptron) annotation GUI:
+SAM2-assisted segmentation, keypoints, line annotations and COCO export.
+
+```bash
+SAM2_BUILD_CUDA=0 pip install git+https://github.com/facebookresearch/sam2.git   # SAM2 library, not on PyPI (Windows: set SAM2_BUILD_CUDA=0 first)
+pip install descriptron-gui
+descriptron-gui          # first start downloads the SAM2 model file (898 MB) into ~/.cache/descriptron/sam2/
+```
+
+SAM2 must be installed from Meta's GitHub into the same environment (PyPI does not allow it as a dependency). If you
+already have `sam2_hiera_large.pt`, copy it to `~/.cache/descriptron/sam2/` or set `DESCRIPTRON_SAM2_CHECKPOINT`
+to its path. Step by step for Windows, macOS and Linux:
+https://github.com/alexrvandam/Descriptron/blob/main/docs/INSTALL_PIP.md
+
+Pulls in `descriptron-core` and `descriptron-vision`: the GUI drives the analysis
+programs directly, so it is not a thin front end over them.
+
+**tkinter** is in the standard library but is not always packaged with Python on
+Linux. If the GUI does not start:
+
+```bash
+sudo apt install python3-tk      # Debian/Ubuntu
+sudo dnf install python3-tkinter # Fedora/RHEL
+```
+
+Model weights are not bundled; they download on first use and are cached. Drag an image or a folder onto the
+window, or start with one: `descriptron-gui path/to/images`.

{descriptron_gui-2.3.0 → descriptron_gui-2.5.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "descriptron-gui"
-version = "2.3.0"
+version = "2.5.2"
 description = "The Descriptron annotation GUI: SAM2-assisted segmentation, keypoints and COCO export"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -24,10 +24,12 @@ classifiers = [
 # fails to start. The GUI drives the analysis scripts directly, so it needs core
 # as well as vision — it is not a thin front end.
 dependencies = [
-  "descriptron-core==2.3.0",
-  "descriptron-vision==2.3.0",
+  "descriptron-core==2.5.2",
+  "descriptron-vision==2.5.2",
   # coloured buttons on macOS (Aqua ignores tk.Button bg); pure Python, Mac only
   "tkmacosx>=1.0.5; sys_platform == 'darwin'",
+  # drag and drop of images/folders onto the window (v78); the GUI starts without it
+  "tkinterdnd2>=0.4",
 ]
 
 [project.optional-dependencies]