[general]
name=AITracer by LAD
description=Click any feature on a georeferenced raster and SAM2 segments it instantly. Refine with positive/negative prompts, then accept to create a vector polygon. All processing runs locally — by LAD, Sapienza University of Rome.
version=0.2.2
qgisMinimumVersion=4.0
about=AITracer by LAD brings AI-assisted raster digitization to QGIS 4.

    Activate the tool, click any feature in a georeferenced raster —
    aerial photo, drone orthophoto, scanned plan — and the SAM2-tiny
    model segments it instantly as a polygon preview. Refine the result
    with positive or negative point prompts, adjust Douglas-Peucker
    simplification, then accept to add the polygon to any vector layer.

    HOW IT WORKS: AITracer captures a screenshot of the current QGIS
    canvas and sends it to SAM2 — it does not read the original raster
    file. This keeps processing fast and memory-light on modest hardware.
    The output resolution depends on your zoom level, not the raster
    resolution. Features that extend beyond the canvas edge will be
    partially traced. The canvas is locked during a session to keep
    pixel-to-map coordinates consistent.

    First-time setup automatically downloads a standalone Python runtime
    and the SAM2-tiny model weights (~160 MB). An internet connection is
    required for this one-time step only. All subsequent processing runs
    entirely on your machine; no data is ever sent to external servers.

    Developed by LAD — Laboratorio di Archeologia Digitale,
    Sapienza University of Rome.
changelog=0.2.2
    - Fix: Qt6 compatibility, fully qualified QgsBlockingNetworkRequest.ErrorCode.NoError.
    0.2.1
    - Fix: address static-analysis (Bandit) findings: no silent exception
      swallowing, subprocess calls documented and restricted to fixed paths.
    0.2.0
    - First stable release (experimental flag removed).
    - New: Pause/Resume. Switching to another QGIS map tool (e.g. Vertex tool)
      pauses AITracer and discards the in-progress preview; press Resume in the
      panel to continue. Backend, target layer and field values are kept.
    - New: "Edit last polygon" button. Selects the last accepted polygon and
      switches to QGIS's native Vertex tool; the selection is cleared on Resume.
    0.1.33
    - Field values panel: preset attributes for accepted polygons.
    0.1.32
    - Model weights stored in ~/.aitracer/weights/, surviving plugin reinstalls.
author=Julian Bogdani | LAD – Laboratorio di Archeologia Digitale, Sapienza University of Rome
email=julian.bogdani@uniroma1.it
homepage=https://github.com/lad-sapienza/ai-tracer
tracker=https://github.com/lad-sapienza/ai-tracer/issues
repository=https://github.com/lad-sapienza/ai-tracer
hasProcessingProvider=no
tags=raster,vectorization,vectorisation,digitizing,digitisation,segmentation,instance segmentation,SAM,SAM2,segment anything,AI,machine learning,archaeology,remote sensing,aerial photo,drone
category=Plugins
icon=icon.png
experimental=False
deprecated=False
