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.8.3

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.8.3
File Size Uploaded Provenance Actions
descriptron_gui-2.8.3.tar.gz 6.1 MB Without provenance Details for descriptron_gui-2.8.3.tar.gz

Built distribution (wheel)

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

Total release size: 12.2 MB

Release files / descriptron_gui-2.8.3.tar.gz

Download URL descriptron_gui-2.8.3.tar.gz
Size 6.1 MB
Tags Source
SHA-256 checksum
How to use checksums
9e46fc9e8cf9d63aa888f5fd56f881b2fe17bc5495740bc6b1e6aa440d6e897f
BLAKE2b-256 checksum
How to use checksums
ffdbbe0adceb635f934d957a4c7d27f1bbcec8ba416c6d89cdc7004a509ec24c
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.8.3-py3-none-any.whl

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

Security for descriptron-gui 2.8.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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