Skip to main content

descriptron

Image annotation, phenomics and evidence-tiered species descriptions.

pip install torch==2.10.0 torchvision==0.25.0 --index-url https://download.pytorch.org/whl/cu128   # NVIDIA; Mac/CPU: drop --index-url
SAM2_BUILD_CUDA=0 pip install git+https://github.com/facebookresearch/sam2.git   # SAM2 library (Windows: set SAM2_BUILD_CUDA=0 first)
pip install descriptron          # analysis programs, detectors and the GUI
descriptron-gui                  # first start downloads the SAM2 model file (898 MB) once
descriptron --list               # the 62 analysis programs

SAM2 is not on PyPI, so it cannot be installed with this package: install it from Meta's GitHub as above, into the same Python (3.10 or newer; 3.12 recommended). The GUI downloads the SAM2 model file sam2_hiera_large.pt once into ~/.cache/descriptron/sam2/; if you already have it, copy it there or set DESCRIPTRON_SAM2_CHECKPOINT. Step by step for Windows, macOS and Linux: https://github.com/alexrvandam/Descriptron/blob/main/docs/INSTALL_PIP.md

This is a convenience package with no code of its own. It installs:

descriptron-core the analysis half — pure pip, no torch, no GPU, no compiler
descriptron-vision torchvision detectors, SAM2-PAL propagation, DINOv3 landmark transfer
descriptron-gui the annotation GUI

If you only want to reproduce an analysis from deposited COCO files, install descriptron-core alone: it needs no model of any kind and installs in about a minute on Linux, macOS and Windows.

Detectron2 is an optional advanced backend and is not installed here — it has no PyPI wheel and needs a compiler. See the repository for the Docker image that carries it ready to run.

Metadata

Release files for descriptron 2.7.8

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 2.7.8
File Size Uploaded
descriptron-2.7.8.tar.gz 7.2 kB Details

Built distribution (wheel)

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

Total release size: 15.0 kB

Release files / descriptron-2.7.8.tar.gz

Download URL descriptron-2.7.8.tar.gz
Size 7.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2a324c77ce8fe2647b25805b74a9fa0c74fca2779094bdf649d6a9d2d7d09971
BLAKE2b-256 checksum
How to use checksums
42fd86a843a87239ee3d51e2309e9f55cc0a2be82998e43e0f76f56fbb7347f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.4

Release files / descriptron-2.7.8-py3-none-any.whl

Download URL descriptron-2.7.8-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8c657b5ec25c9f699512dbfad57e845f0d36c219f714461e357aec4288e0c25f
BLAKE2b-256 checksum
How to use checksums
383cd8332d08e98d0f1fa5b6e7531cd251d855b3b2f936cbc372cc3bd2c918e3
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

This release

2.7.8 This release

2 release files

2.7.6

2 release files

2.7.5

2 release files

2.7.0

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