zwette/ipyannotations

Image annotations in python using jupyter notebooks

ipyannotations: create rich annotations in jupyter notebooks.

The ipyannotations library is designed to let you create rich annotations for your data (currently, primarily images) inside jupyter notebooks. It lets you leverage the rich jupyter display system from python. It was designed to integrate with superintendent, but does not need to.

For example, draw polygons onto images for your machine learning applications:

Installation

Start by installing ipyannotations:

$ pip install ipyannotations

If you are using Jupyter Lab, rather than the old Jupyter Notebook application, you will also have to install two Jupyter Lab extensions:

Jupyter Lab extensions

$ jupyter labextension install @jupyter-widgets/jupyterlab-manager ipycanvas
$ jupyter lab build

ipyannotations development

It's super helpful to have other people contribute to projects like this, so please fork this repository and make pull requests!

ipyannotations uses flit to manage the packaging, so the easiest way to use it is to set up a virtual environment, install ipyannotations as a symlink, and go from there:

git clone [email protected]:<your-username>/ipyannotations.git && cd ipyannotations
pre-commit install
python -m venv .venv
flit install --symlink --python .venv/bin/python
jupyter labextension install @jupyter-widgets/jupyterlab-manager ipycanvas
jupyter lab build