PyImageLabeling
- Documentation: Read the documentation.
- GitHub Repository: View codesource.
- PyPI: Install via pip.
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.
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.