Skip to main content

descriptron-gui

The Descriptron annotation GUI: SAM2-assisted segmentation, keypoints, line annotations and COCO export.

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:

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.

Metadata

Release files for descriptron-gui 2.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for descriptron-gui 2.7.0
File Size Uploaded
descriptron_gui-2.7.0.tar.gz 2.9 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for descriptron-gui 2.7.0
File Interpreter ABI Platform
descriptron_gui-2.7.0-py3-none-any.whl Python 3 none any Details

Total release size: 5.8 MB

Release files / descriptron_gui-2.7.0.tar.gz

Download URL descriptron_gui-2.7.0.tar.gz
Size 2.9 MB
Tags Source
SHA-256 checksum
How to use checksums
b77cfee85696e9a133ee18b3b775f34afa096af9d070094ddf5c8329e6a38b50
BLAKE2b-256 checksum
How to use checksums
ca6205efd5cd023f2d66191c2abe4daa767663b89a8932de9943eec35191b9e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.4

Release files / descriptron_gui-2.7.0-py3-none-any.whl

Download URL descriptron_gui-2.7.0-py3-none-any.whl
Size 2.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
d5a3f4fd9d14054744d0450aaa5f451b85e1cdc722881710b6d2d059823d15fd
BLAKE2b-256 checksum
How to use checksums
407fc18c9dac4417c00a375b548c0cdc93a4c614b1e9e7384597938a650163af
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.4

Release history Release notifications | RSS feed

2.7.8

2 release files

2.7.6

2 release files

2.7.5

2 release files

This release

2.7.0 This release

2 release files

2.6.0

2 release files

2.5.2

2 release files

2.5.1

2 release files

2.3.0

2 release files

2.2.0

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page