Simple Image Annotation Tool.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for wkentaro from gravatar.com wkentaro

Unverified details

These details have not been verified by PyPI
Project links
GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: MIT License (GPLv3)

Author: Kentaro Wada

Tags Image, Annotation

Classifiers

Project description

labelme: Image Annotation Tool with Python
==========================================

[![Build Status](https://travis-ci.org/wkentaro/labelme.svg?branch=master)](https://travis-ci.org/wkentaro/labelme)


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
------------

- [PyQt4](http://www.riverbankcomputing.co.uk/software/pyqt/intro)


Installation
------------

**Docker**

You need install [docker](https://www.docker.com), then just run below:

```bash
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/IMG_6319.jpg -O _static/IMG_6319.json
```

**Ubuntu**

```bash
sudo apt-get install python-qt4 pyqt4-dev-tools

sudo pip install labelme
```

**OS X**

```bash
brew install qt qt4

pip install labelme
```

**macOS Sierra**

```bash
brew install pyqt5

pip install git+https://github.com/wkentaro/labelme.git@pyqt5
```


Usage
-----

**Annotation**

Run `labelme --help` for detail.

```bash
labelme # Open GUI
labelme _static/IMG_6319.jpg # Specify file
labelme _static/IMG_6319.jpg -O _static/IMG_6319.json # Close window after the save
```

The annotations are saved as a [JSON](http://www.json.org/) file. The
file includes the image itself.

**Visualization**

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

```bash
labelme_draw_json _static/IMG_6319.json
```

**Convert to Dataset**

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


```bash
labelme_json_to_dataset _static/IMG_6319.json
```


Sample
------

- [Original Image](https://github.com/wkentaro/labelme/blob/master/_static/IMG_6319.jpg)
- [Screenshot](https://github.com/wkentaro/labelme/blob/master/_static/IMG_6319_screenshot.png)
- [Generated Json File](https://github.com/wkentaro/labelme/blob/master/_static/IMG_6319.json)
- [Visualized Json File](https://github.com/wkentaro/labelme/blob/master/_static/IMG_6319_draw_json.png)


Screencast
----------

<img src="https://github.com/wkentaro/labelme/raw/master/_static/screencast.gif" width="70%"/>

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for wkentaro from gravatar.com wkentaro

Unverified details

These details have not been verified by PyPI
Project links
GitHub Statistics

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: MIT License (GPLv3)

Author: Kentaro Wada

Tags Image, Annotation

Classifiers

Release history Release notifications | RSS feed

5.4.1

5.4.0.post1

5.4.0.post0

5.4.0

5.4.0a0 pre-release

5.3.1

5.3.0

5.3.0a0 pre-release

5.2.1

5.2.0.post4

5.2.0.post3

5.2.0.post2

5.2.0.post1

5.2.0.post0

5.2.0

5.1.1

5.1.0

5.0.5

5.0.4

5.0.3

5.0.2

5.0.1

5.0.1a0 pre-release

5.0.0

4.6.0

4.5.13

4.5.12

4.5.11

4.5.10

4.5.9

4.5.8.post0

4.5.8

4.5.7

4.5.6

4.5.5

4.5.4

4.5.3

4.5.2

4.5.1

4.5.0

4.4.0

4.3.1

4.3.0

4.2.10

4.2.9

4.2.8

4.2.7

4.2.6

4.2.5

4.2.4

4.2.3

4.2.2

4.2.1

4.2.0

4.1.4

4.1.3

4.1.2

4.1.1

4.1.0

4.0.2

4.0.1

4.0.0

3.22.2

3.22.1

3.22.0

3.21.1

3.21.0

3.20.2

3.20.1

3.20.0

3.19.1

3.19.0

3.18.0

3.17.0

3.16.7

3.16.6

3.16.5

3.16.4

3.16.3

3.16.2

3.16.1

3.16.0

3.15.2

3.15.1

3.15.0

3.14.2

3.14.1

3.14.0

3.13.1

3.13.0

3.12.0

3.11.2

3.11.1

3.11.0

3.10.1

3.10.0

3.9.1

3.9.0

3.8.2

3.8.1

3.8.0

3.7.3

3.7.2

3.7.1

3.7.0

3.6.16

3.6.15

3.6.14

3.6.13

3.6.12

3.6.11

3.6.10

3.6.9

3.6.8

3.6.7

3.6.6

3.6.5

3.6.4

3.6.3

3.6.2

3.6.1

3.6.0

3.5.0

3.4.1

3.4.0

3.3.7

3.3.6

3.3.5

3.3.4

3.3.3

3.3.2

3.3.1

3.3.0

3.2.4

3.2.3

3.2.2

3.2.1

3.2.0

3.1.1

3.1.0

3.0.1

3.0.0

2.15.0

2.14.3

2.14.1

2.14.0

2.13.2

2.13.1

2.13.0

2.12.0

2.11.0

2.10.5

2.10.4

2.10.3

2.10.2

2.10.1

2.10.0

2.9.0

2.8.0

2.7.3

2.7.2

2.7.1

2.7.0

2.6.4

2.6.3

2.6.2

2.6.1

2.6.0

2.5.4

2.5.3

2.5.2

2.5.1

2.5.0

2.4.0

This version

2.3.1

2.3.0

2.2.2

2.2.1

2.2.0

2.1.0

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

1.2.3

1.2.2

1.2.1

1.2.0

1.1.6

1.1.5

1.1.4

1.1.3

1.1.2

1.1.1

1.1.0

1.0.1

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

labelme-2.3.1.tar.gz (161.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page