mustatil 5.0.0__tar.gz

mustatil-5.0.0/DEPLOY_TO_PYPI.md

@@ -0,0 +1,70 @@
+# Deploy Mustatil to PyPI
+
+## 1. Local editable test
+
+```powershell
+cd mustatil_pip_source
+py -m pip install --upgrade pip
+py -m pip install -e ".[yolo,gis,onnx,vision,science,webui]"
+mustatil
+```
+
+## 2. Install PyTorch separately
+
+CPU-only example:
+
+```powershell
+py -m pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu
+```
+
+CUDA 12.1 example matching the original requirements file:
+
+```powershell
+py -m pip install torch==2.4.1+cu121 torchvision==0.19.1+cu121 torchaudio --extra-index-url https://download.pytorch.org/whl/cu121
+```
+
+Do not put `--extra-index-url` lines into `pyproject.toml` dependencies. Keep PyTorch installation as a separate documented step.
+
+## 3. Build distributions
+
+```powershell
+py -m pip install --upgrade build twine
+py -m build
+py -m twine check dist/*
+```
+
+## 4. Upload to TestPyPI first
+
+```powershell
+py -m twine upload --repository testpypi dist/*
+```
+
+Install-test from TestPyPI:
+
+```powershell
+py -m pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple mustatil
+mustatil
+```
+
+## 5. Upload to PyPI
+
+```powershell
+py -m twine upload dist/*
+```
+
+## Important package policy
+
+The PyPI package should stay code-first. Keep these files out of the package:
+
+- `.pt`, `.onnx` model files
+- generated model caches
+- installer/uninstaller `.exe` files
+- local virtual environments
+- temporary tiles and outputs
+
+Recommended external asset channels:
+
+- GitHub Releases for small/medium assets
+- Hugging Face for model weights
+- Zenodo for citable datasets/releases
+- itch.io for the full Windows installer

mustatil-5.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include DEPLOY_TO_PYPI.md
+recursive-include src/mustatil *.py *.json *.ico *.mustatil *.txt
+recursive-include src/mustatil/mustatil_plugins *.py
+prune src/mustatil/__pycache__
+global-exclude *.py[cod] __pycache__ *.pt *.onnx *.exe *.dat *.bat

mustatil-5.0.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: mustatil
+Version: 5.0.0
+Summary: GIS-level AI vision workspace for annotation, YOLO training, satellite detection, geospatial inference, and visual AI pipelines.
+Author: Tarek Wasfy
+Project-URL: Homepage, https://mustatil.de/
+Project-URL: Repository, https://github.com/tarekwasfy01/Mustatil-YOLO-AI-Model-Trainer-
+Project-URL: Download, https://tarekwasfy01.itch.io/mustatil-qt-workspace
+Project-URL: DOI, https://doi.org/10.5281/zenodo.20481111
+Keywords: yolo,gis,remote-sensing,computer-vision,annotation,satellite-imagery,geopackage,geotiff,ai-pipeline
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: <3.13,>=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: PySide6<6.10,>=6.7
+Requires-Dist: Pillow>=10
+Requires-Dist: numpy<2.3,>=1.26
+Requires-Dist: requests>=2.31
+Requires-Dist: tqdm>=4.66
+Requires-Dist: pyyaml>=6
+Requires-Dist: psutil
+Requires-Dist: opencv-python>=4.9
+Provides-Extra: yolo
+Requires-Dist: ultralytics>=8.3; extra == "yolo"
+Provides-Extra: gis
+Requires-Dist: rasterio>=1.3; extra == "gis"
+Requires-Dist: fiona>=1.9; extra == "gis"
+Requires-Dist: geopandas>=0.14; extra == "gis"
+Requires-Dist: shapely>=2.0; extra == "gis"
+Requires-Dist: pyproj>=3.6; extra == "gis"
+Requires-Dist: rtree; extra == "gis"
+Requires-Dist: affine; extra == "gis"
+Requires-Dist: snuggs; extra == "gis"
+Requires-Dist: cligj; extra == "gis"
+Requires-Dist: click; extra == "gis"
+Requires-Dist: click-plugins; extra == "gis"
+Provides-Extra: onnx
+Requires-Dist: onnx>=1.16; extra == "onnx"
+Requires-Dist: onnxruntime>=1.17; extra == "onnx"
+Provides-Extra: vision
+Requires-Dist: transformers==4.57.3; extra == "vision"
+Requires-Dist: tokenizers<0.23,>=0.21.4; extra == "vision"
+Requires-Dist: accelerate<2,>=1.5.2; extra == "vision"
+Requires-Dist: safetensors; extra == "vision"
+Requires-Dist: huggingface_hub<1.0,>=0.34; extra == "vision"
+Requires-Dist: sentencepiece; extra == "vision"
+Requires-Dist: qwen-vl-utils; extra == "vision"
+Requires-Dist: timm>=1.0.11; extra == "vision"
+Requires-Dist: einops; extra == "vision"
+Requires-Dist: einops-exts; extra == "vision"
+Requires-Dist: shortuuid; extra == "vision"
+Requires-Dist: peft>=0.12.0; extra == "vision"
+Requires-Dist: datasets>=2.21.0; extra == "vision"
+Requires-Dist: python-dotenv; extra == "vision"
+Requires-Dist: filetype; extra == "vision"
+Requires-Dist: imagehash; extra == "vision"
+Requires-Dist: av; extra == "vision"
+Requires-Dist: decord; extra == "vision"
+Requires-Dist: lmdb; extra == "vision"
+Requires-Dist: ebmlite; extra == "vision"
+Requires-Dist: httpx>=0.24.0; extra == "vision"
+Provides-Extra: science
+Requires-Dist: scipy>=1.12; extra == "science"
+Requires-Dist: pandas>=2.2; extra == "science"
+Requires-Dist: matplotlib>=3.8; extra == "science"
+Requires-Dist: pyqtgraph; extra == "science"
+Requires-Dist: scikit-learn>=1.4; extra == "science"
+Requires-Dist: scikit-image; extra == "science"
+Requires-Dist: albumentations; extra == "science"
+Requires-Dist: supervision; extra == "science"
+Requires-Dist: filterpy; extra == "science"
+Requires-Dist: lapx; extra == "science"
+Requires-Dist: networkx; extra == "science"
+Requires-Dist: imageio; extra == "science"
+Requires-Dist: imageio-ffmpeg; extra == "science"
+Requires-Dist: sympy; extra == "science"
+Requires-Dist: protobuf; extra == "science"
+Requires-Dist: numba; extra == "science"
+Provides-Extra: webui
+Requires-Dist: fastapi; extra == "webui"
+Requires-Dist: uvicorn; extra == "webui"
+Requires-Dist: markdown2[all]; extra == "webui"
+Requires-Dist: gradio; extra == "webui"
+Requires-Dist: gradio_client; extra == "webui"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+
+# Mustatil
+
+Mustatil is a GIS-level AI vision workspace for annotation, YOLO training, large-scale detection, satellite-map analysis, geospatial inference, GeoPackage/GIS export, and visual AI pipeline building.
+
+This PyPI package contains the Python application code and bundled plugins. Large model weights and generated runtime files are intentionally excluded and should be distributed separately through GitHub Releases, Hugging Face, Zenodo, itch.io, or downloaded by the application into a user runtime folder.
+
+## Install
+
+```powershell
+pip install mustatil
+mustatil
+```
+
+For a fuller install with optional GIS/AI dependencies:
+
+```powershell
+pip install "mustatil[yolo,gis,onnx,vision,science,webui]"
+```
+
+PyTorch should be installed separately according to the target hardware, especially when CUDA wheels are required.
+
+## Run
+
+```powershell
+mustatil
+```
+
+Or:
+
+```powershell
+python -m mustatil
+```
+
+## Notes
+
+The original desktop ZIP contained large model files such as `sam2_b.pt`, `Houses300.pt`, `Houses300.onnx`, `Tree50.pt`, and `yolov8n.pt`. These files are not included in this source package.

mustatil-5.0.0/README.md

@@ -0,0 +1,36 @@
+# Mustatil
+
+Mustatil is a GIS-level AI vision workspace for annotation, YOLO training, large-scale detection, satellite-map analysis, geospatial inference, GeoPackage/GIS export, and visual AI pipeline building.
+
+This PyPI package contains the Python application code and bundled plugins. Large model weights and generated runtime files are intentionally excluded and should be distributed separately through GitHub Releases, Hugging Face, Zenodo, itch.io, or downloaded by the application into a user runtime folder.
+
+## Install
+
+```powershell
+pip install mustatil
+mustatil
+```
+
+For a fuller install with optional GIS/AI dependencies:
+
+```powershell
+pip install "mustatil[yolo,gis,onnx,vision,science,webui]"
+```
+
+PyTorch should be installed separately according to the target hardware, especially when CUDA wheels are required.
+
+## Run
+
+```powershell
+mustatil
+```
+
+Or:
+
+```powershell
+python -m mustatil
+```
+
+## Notes
+
+The original desktop ZIP contained large model files such as `sam2_b.pt`, `Houses300.pt`, `Houses300.onnx`, `Tree50.pt`, and `yolov8n.pt`. These files are not included in this source package.

mustatil-5.0.0/pyproject.toml

@@ -0,0 +1,144 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mustatil"
+version = "5.0.0"
+description = "GIS-level AI vision workspace for annotation, YOLO training, satellite detection, geospatial inference, and visual AI pipelines."
+readme = "README.md"
+requires-python = ">=3.10,<3.13"
+authors = [
+    { name = "Tarek Wasfy" }
+]
+keywords = [
+    "yolo",
+    "gis",
+    "remote-sensing",
+    "computer-vision",
+    "annotation",
+    "satellite-imagery",
+    "geopackage",
+    "geotiff",
+    "ai-pipeline"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: End Users/Desktop",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Multimedia :: Graphics",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux"
+]
+dependencies = [
+    "PySide6>=6.7,<6.10",
+    "Pillow>=10",
+    "numpy>=1.26,<2.3",
+    "requests>=2.31",
+    "tqdm>=4.66",
+    "pyyaml>=6",
+    "psutil",
+    "opencv-python>=4.9"
+]
+
+[project.optional-dependencies]
+yolo = [
+    "ultralytics>=8.3"
+]
+gis = [
+    "rasterio>=1.3",
+    "fiona>=1.9",
+    "geopandas>=0.14",
+    "shapely>=2.0",
+    "pyproj>=3.6",
+    "rtree",
+    "affine",
+    "snuggs",
+    "cligj",
+    "click",
+    "click-plugins"
+]
+onnx = [
+    "onnx>=1.16",
+    "onnxruntime>=1.17"
+]
+vision = [
+    "transformers==4.57.3",
+    "tokenizers>=0.21.4,<0.23",
+    "accelerate>=1.5.2,<2",
+    "safetensors",
+    "huggingface_hub>=0.34,<1.0",
+    "sentencepiece",
+    "qwen-vl-utils",
+    "timm>=1.0.11",
+    "einops",
+    "einops-exts",
+    "shortuuid",
+    "peft>=0.12.0",
+    "datasets>=2.21.0",
+    "python-dotenv",
+    "filetype",
+    "imagehash",
+    "av",
+    "decord",
+    "lmdb",
+    "ebmlite",
+    "httpx>=0.24.0"
+]
+science = [
+    "scipy>=1.12",
+    "pandas>=2.2",
+    "matplotlib>=3.8",
+    "pyqtgraph",
+    "scikit-learn>=1.4",
+    "scikit-image",
+    "albumentations",
+    "supervision",
+    "filterpy",
+    "lapx",
+    "networkx",
+    "imageio",
+    "imageio-ffmpeg",
+    "sympy",
+    "protobuf",
+    "numba"
+]
+webui = [
+    "fastapi",
+    "uvicorn",
+    "markdown2[all]",
+    "gradio",
+    "gradio_client"
+]
+dev = [
+    "build",
+    "twine",
+    "pytest"
+]
+
+[project.urls]
+Homepage = "https://mustatil.de/"
+Repository = "https://github.com/tarekwasfy01/Mustatil-YOLO-AI-Model-Trainer-"
+Download = "https://tarekwasfy01.itch.io/mustatil-qt-workspace"
+DOI = "https://doi.org/10.5281/zenodo.20481111"
+
+[project.gui-scripts]
+mustatil = "mustatil.launcher:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+mustatil = [
+    "*.json",
+    "*.ico",
+    "*.mustatil",
+    "*.txt",
+    "mustatil_plugins/*.py"
+]

mustatil-5.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mustatil-5.0.0/src/mustatil/MODEL_FILES_NOT_INCLUDED.txt

@@ -0,0 +1,15 @@
+Large model/runtime files from the original desktop ZIP are intentionally not included in the PyPI source package.
+
+Excluded from PyPI packaging:
+- sam2_b.pt
+- Houses300.pt
+- Houses300.onnx
+- Tree50.pt
+- yolov8n.pt
+- sam2_all_polygons.json
+- unins000.exe / unins000.dat
+- Windows BAT installer/launcher files
+
+Reason: PyPI has a default single-file upload limit, and model files should be distributed through GitHub Releases, Hugging Face, Zenodo, itch.io, or downloaded into a user runtime cache.
+
+For a local developer install you can still place these files next to mustatil_qt_workspace.py inside the installed package folder, or better adapt Mustatil to read them from an external user data folder.

mustatil-5.0.0/src/mustatil/Mustatil_Project.mustatil

@@ -0,0 +1,58 @@
+{
+  "project_name": "Khirigsuurs",
+  "project_file": "C:\\Users\\Tarek\\AppData\\Local\\Programs\\Mustatil\\Mustatil_Project.mustatil",
+  "project_root": "G:\\Khirigsuurs",
+  "image_folder": "G:\\Khirigsuurs\\images",
+  "label_folder": "G:\\Khirigsuurs\\labels",
+  "crop_folder": "G:\\Khirigsuurs\\crops",
+  "export_folder": "G:\\Khirigsuurs\\exports",
+  "weights_folder": "G:\\Khirigsuurs\\weights",
+  "sam_folder": "G:\\Khirigsuurs\\sam2",
+  "runs_folder": "G:\\Khirigsuurs\\runs",
+  "train_output_folder": "G:\\Khirigsuurs\\runs",
+  "yolo_models": [
+    "G:/Khirigsuurs/runs/train_mustatil/weights/best.pt",
+    "",
+    ""
+  ],
+  "detection_model_preset": "Custom",
+  "satellite_detection_model_preset": "Custom",
+  "image": "C:/Users/Tarek/Desktop/Khirgisuurs.tif",
+  "output": "",
+  "sam_model": "sam2_b.pt",
+  "sam_device": "cpu",
+  "satellite_map_preset": "Google Satellite",
+  "satellite_url_template": "https://mt.google.com/vt/lyrs=s&x={x}&y={y}&z={z}&hl=de",
+  "satellite_preview_map_preset": "Esri World Imagery",
+  "satellite_preview_url_template": "https://mt.google.com/vt/lyrs=s&x={x}&y={y}&z={z}&hl=de",
+  "satellite_zoom": 18,
+  "satellite_cache_dir": "C:\\Users\\tarek\\mustatil_satellite_cache",
+  "satellite_output_gpkg": "",
+  "satellite_output_tif": "C:/Users/tarek/Desktop/asdasdasd.tif",
+  "train_model": "G:/Khirigsuurs/runs/train_mustatil/weights/best.pt",
+  "formlearner_model": "",
+  "auto_annotate_yolo_model": "",
+  "auto_annotate_yolo_confidence": 0.001,
+  "tile_size": 1024,
+  "overlap": 384,
+  "shifted_tiles": true,
+  "yolo_confidence": 0.05,
+  "preview_confidence": 0.1,
+  "formscore_preview": 0.0,
+  "detection_min_score": 0.0,
+  "detection_min_consensus": 1,
+  "formscore_threshold": 0.5,
+  "crop_size": 1024,
+  "crop_padding": 128,
+  "epochs": 5,
+  "imgsz": 1024,
+  "batch": 8,
+  "device": "cuda",
+  "classes": [
+    "mustatil",
+    "false_positive"
+  ],
+  "created": "2026-05-26 16:37:52",
+  "modified": "2026-06-04 15:12:37",
+  "version": 1
+}

mustatil-5.0.0/src/mustatil/__init__.py

@@ -0,0 +1,3 @@
+"""Mustatil: GIS-level AI vision workspace."""
+
+__version__ = "5.0.0"

mustatil-5.0.0/src/mustatil/__main__.py

@@ -0,0 +1,3 @@
+from mustatil.launcher import main
+
+raise SystemExit(main())