A simple plugin to label image

License BSD-3 PyPI Python Version tests codecov napari hub

A simple plugin to label image

This napari plugin was generated with Cookiecutter using @napari's cookiecutter-napari-plugin template.



You can install napari-simpleannotate via pip:

pip install napari-simpleannotate

To install latest development version :

pip install git+

How to use

  1. Opening Files or Directories:

    • Click the Open File button to open an image file.
    • Click the Open Directory button to open a directory containing images.
    • If there's a class.yaml in the directory of the selected file or within the selected directory, it will be automatically detected. A popup will appear, giving you the option to load it.
  2. Class Management:

    • Enter the class name in the textbox and click the Add class button to add a class. When adding a class name, a number is automatically assigned to it. This number will be used when saving annotations.
    • Select a class from the class list and click the Delete selected class button to remove it.
  3. Annotating Images:

    • Use napari's rectangle tool to annotate the images. If you have a class selected, the annotation will automatically be assigned to that class.
    • For existing rectangles, you can change their class by selecting the rectangle and then choosing a different class from the list.
  4. Saving Annotations:

    • Click the Save Annotations button to save the annotations in YOLO format.
    • Along with saving the annotations, the class.yaml will also be saved. If a class.yaml already exists and its content is different from the current one, a popup will appear asking for confirmation to overwrite it.


Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.


Distributed under the terms of the BSD-3 license, "napari-simpleannotate" is free and open source software


If you encounter any problems, please file an issue along with a detailed description.


  • 0.0.3

Last updated:

  • 29 October 2023

First released:

  • 29 October 2023


Supported data:

  • Information not submitted

Plugin type:

GitHub activity:

  • Stars: 0
  • Forks: 0
  • Issues + PRs: 0

Python versions supported:

Operating system:


  • numpy
  • magicgui
  • pyyaml
  • qtpy
  • scikit-image

Sign up to receive updates