No Description

Kentaro Wada a43f3f2bbf Use pip 7 years ago
docker 798e9b9cab Update dockerfile 8 years ago
labelme 564cd22519 Update app.py 7 years ago
scripts 056df0794e Support linux on labelme_on_docker 8 years ago
static 430e7f916b Make repo light 8 years ago
tests b00506f760 _static -> static 7 years ago
.gitignore 9ba752183c Prepare source to release pypi 9 years ago
.travis.yml c1afeca807 Email false 7 years ago
LICENSE e0f2d45054 Rename COPYING -> LICENSE 9 years ago
MANIFEST.in 9962d0adbf rst to md 9 years ago
README.md 5ad6d34fac Add Appveyor Status badge 7 years ago
appveyor.yml a43f3f2bbf Use pip 7 years ago
setup.py 2390881635 2.5.1 7 years ago

README.md

labelme: Image Annotation Tool with Python

PyPI Version Travis Build Status Appveyor Build status Docker Build Status

Labelme is a graphical image annotation tool inspired by http://labelme.csail.mit.edu.

It is written in Python and uses Qt for its graphical interface.

Dependencies

Installation

There are options:

  • Platform agonistic installation: Anaconda, Docker
  • Platform specific installation: Ubuntu, macOS

Anaconda

You need install Anaconda, then run below:

conda create --name=labelme python=2.7
source activate labelme
conda install pyqt
pip install labelme

Docker

You need install docker, then run below:

wget https://raw.githubusercontent.com/wkentaro/labelme/master/scripts/labelme_on_docker
chmod u+x labelme_on_docker

# Maybe you need http://sourabhbajaj.com/blog/2017/02/07/gui-applications-docker-mac/ on macOS
./labelme_on_docker static/apc2016_obj3.jpg -O static/apc2016_obj3.json

Ubuntu

sudo apt-get install python-qt4 pyqt4-dev-tools
sudo pip install labelme

macOS

brew install qt qt4 || brew install pyqt  # qt4 is deprecated
pip install labelme

Usage

Annotation

Run labelme --help for detail.

labelme  # Open GUI
labelme static/apc2016_obj3.jpg  # Specify file
labelme static/apc2016_obj3.jpg -O static/apc2016_obj3.json  # Close window after the save

The annotations are saved as a JSON file. The file includes the image itself.

Visualization

To view the json file quickly, you can use utility script:

labelme_draw_json static/apc2016_obj3.json

Convert to Dataset

To convert the json to set of image and label, you can run following:

labelme_json_to_dataset static/apc2016_obj3.json

Sample

Screencast