Skip to main content

PyImageLabeling logo

PyPI downloads Exe downloads PyPI version Python License: MIT

Build Linux Build MacOS Build Windows Windows exe

Linux tests MacOS tests Windows tests

PyImageLabeling

PyImageLabeling is a powerful tool with a user-friendly interface based on PyQT6 for creating image masks. These labeled images are used in the creation of machine learning models dedicated to computer vision tasks.

Features

Labeling

  • Pixel-by-pixel: paintbrush, magic pen (selects similar colors, RGB or HSV tolerance) and contour filling.
  • Geometric shapes: polygon, rectangle and ellipse.
  • Several labels per image, each with its own color, opacity and visibility.

Editing

  • Smart eraser: erase freely, or only a color range with an adjustable tolerance.
  • Change labeled area: move an annotated region to another label.
  • Undo with a configurable depth, and Clear All.

AI assistance (optional: models are downloaded from Hugging Face on first use, and the GPU is used when available)

  • SAM Assist: click to add (+) or remove (−) points, or drag a box, and Segment Anything draws the mask. Presets range from fast to precise, plus a medical model (MedSAM).
  • Text-to-mask: describe the object in English or French (colors, shapes, position); Grounding DINO finds it and SAM draws the mask.
  • One-shot propagation: annotate one image and propagate the label to all the others (DINOv2 + SAM, no training), then step through the batch to review and fix it.
  • Train a model on your annotations: segmentation (ResNet or DINOv2 backbone) and detection; predict the current image, then accept or clear the predictions.
  • Active learning: Suggest next to label jumps to the image the model is least sure about.

Images and workflow

  • Image options: brightness, contrast, gamma, saturation, hue, sharpness, grayscale, color inversion and color replacement, saved as reusable presets.
  • Import existing masks as labels.
  • Never lose your work: auto-save, recovery after a crash, and saves that cannot be left half-written; Help > Crash Report & Logs shows what happened.
  • Menu bar and keyboard shortcuts.
PyImageLabeling Interface
Overview of PyImageLabeling in the context of an application related to pancreatic cancer.



PyImageLabeling Interface
Overview of PyImageLabeling with the Flood Area Segmentation dataset.

Installation and Run

Note that you need first Python 3 (version 3.12, or later) to be installed. You can do it, for example, from Python.org.

PyPi installation (Windows, Mac and Linux)

Check whether you have the last version of PyPi:

python3 -m pip install -U pip

Install PyImageLabeling:

python3 -m pip install -U PyImageLabeling

To launch PyImageLabeling:

pyimagelabeling

(python3 -m PyImageLabeling works too.)

Without installing Python yourself: uv (Windows, Mac and Linux)

uv downloads a suitable Python by itself and installs PyImageLabeling in its own environment:

uv tool install PyImageLabeling
pyimagelabeling

Update later with uv tool upgrade PyImageLabeling.

Executable ".exe" (Windows)

Download PyImageLabeling_vX.Y.Z.exe from the latest release. Just double-click on the executable file to launch PyImageLabeling (no Python needed; machine learning runs on the CPU).

Github Installation (Windows, Mac and Linux)

Here is an illustration for Linux. We assume that Python 3 is installed, and consequently ‘pip3’ is also installed. In a console, type:

git clone https://github.com/crillab/PyImageLabeling.git

You may need to update the environment variable ‘PYTHONPATH’, by typing for example:

export PYTHONPATH="${PYTHONPATH}:${PWD}/.."

Get the last version of pip:

python3 -m pip install --upgrade pip

Executes the pyproject.toml inside the PyImageLabeling directory and installs dependencies ("numpy", "pyqt6", "opencv-python", "pillow", "matplotlib").

python3 -m pip install -e .

To launch PyImageLabeling:

python3 -m PyImageLabeling

License

This project is licensed under the MIT License - see the LICENSE file for details.

Use Cases

  • Computer Vision: Create training datasets for object detection and segmentation
  • Medical Imaging: Annotate medical scans and diagnostic images
  • Autonomous Vehicles: Label road scenes and traffic elements
  • Agriculture: Mark crop areas and plant health indicators
  • Quality Control: Identify defects and areas of interest in industrial applications

Metadata

Release files for PyImageLabeling 1.0.14

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

Source distribution (sdist)

Source distribution for PyImageLabeling 1.0.14
File Size Uploaded Provenance Actions
pyimagelabeling-1.0.14.tar.gz 455.5 kB With provenance Details for pyimagelabeling-1.0.14.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for PyImageLabeling 1.0.14
File Interpreter ABI Platform Actions
pyimagelabeling-1.0.14-py3-none-any.whl Python 3 none any Details for pyimagelabeling-1.0.14-py3-none-any.whl

Total release size: 929.6 kB

Release files / pyimagelabeling-1.0.14.tar.gz

Download URL pyimagelabeling-1.0.14.tar.gz
Size 455.5 kB
Tags Source
SHA-256 checksum
How to use checksums
c13197ea2e9900d2ba5aa7df0c6c4b87c9c0302f369f18f6c035a56e4b1200c4
BLAKE2b-256 checksum
How to use checksums
d8d73ddb73c60dd71dd32e780e4b1be9c7220a9f4719aa54e9b2905cfc6e19d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Release files / pyimagelabeling-1.0.14-py3-none-any.whl

Download URL pyimagelabeling-1.0.14-py3-none-any.whl
Size 474.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
65dc88c12e0987196c1c51822ce9dd11bf82e7443a8658f15d2bfbf6d6890c79
BLAKE2b-256 checksum
How to use checksums
5274a4867edbb05abe8184894104246f8ed2a37d589764d997f38b1717e2bce2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

Security for PyImageLabeling 1.0.14

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pyimagelabeling-1.0.14.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 24, 2026.

Transparency log

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