wkentaro /labelme

Image annotation with Python. Supports polygon, rectangle, circle, line, point, and AI-assisted annotation.

★ 16,321⑂ 3,729👁 147⑃ 1,729● 1,013▤ 115
PythonGPL-3.0Created 2016-05-09labelme.io
下载:v7.11.0v7.11.0 ↓7.11.02026-11-14
+4
日增长
16,321
stars
3,729
forks
147
watchers
1,729
prs
1,013
issues
115
releases

README

labelme



  Image annotation with Python.



  
   --
  
  



  Installation
  | Usage
  | Examples
  | labelme.io ↗
  Community --
  Youtube FAQ --





  


 Description

Labelme is a graphical image annotation tool inspired by .\
It is written in Python and uses Qt for its graphical interface.

 Looking for a simple install without Python or Qt? Get the standalone app at labelme.io.

    \
VOC dataset example of instance segmentation.

  \
Other examples (semantic segmentation, bbox detection, and classification).

  \
Various primitives (polygon, rectangle, circle, line, and point).


Multi-language support (English, 中文, 日本語, 한국어, Deutsch, Français, and more).

 Features

- [x] Image annotation for polygon, rectangle, circle, line and point (tutorial)
- [x] Image flag annotation for classification and cleaning (166)
- [x] Video annotation (video annotation)
- [x] GUI customization (predefined labels / flags, auto-saving, label validation, etc) (144)
- [x] Exporting VOC-format dataset for semantic segmentation, instance segmentation
- [x] Exporting COCO-format dataset for instance segmentation
- [x] AI-assisted point-to-polygon/mask annotation by SAM, EfficientSAM models
- [x] AI text-to-annotation by YOLO-world, SAM3 models

🌏 Available in 21 languages - English · 日本語 · 한국어 · 简体中文 · 繁體中文 · Deutsch · Ελληνικά · Français · Español · Italiano · Português · Nederlands · Magyar · Русский · ไทย · Tiếng Việt · Türkçe · Українська · Polski · Bahasa Indonesia · فارسی (LANG=ja_JP.UTF-8 labelme)

 Installation

There are 3 options to install labelme:

 Option 1: Using pip

For more detail, check "Install Labelme using Terminal"

bash
pip install labelme

 To install the latest version from GitHub:
 pip install git+https://github.com/wkentaro/labelme.git


 Option 2: Using standalone executable (Easiest)

If you're willing to invest in the convenience of simple installation without any dependencies (Python, Qt),
you can download the standalone executable from "Install Labelme as App".

It's a one-time payment for lifetime access, and it helps us to maintain this project.

 Option 3: Linux distribution packages

On some Linux distributions, labelme is also packaged in the system's native repository and can be installed with the distribution's standard package tooling. The badge below tracks which distributions currently ship labelme and which version each one provides:



 Supported Python and platforms

| | Supported (v7.x) | Maintenance (v6.3.x) |
| ------ | ------------------------------ | -------------------- |
| Python | 3.12 - 3.14 | 3.10 - 3.11 |
| Qt | Qt6 (PySide6) | Qt5 |
| OS | 64-bit macOS / Windows / Linux | older OSes |

labelme follows SPEC 0 (the successor to NEP 29) for dropping Python versions, in step with its core scientific dependencies (numpy, scipy, scikit-image). v6.3.x is the maintenance line for Qt5 and Python 3.10 / 3.11 stragglers.

v6.3.x receives critical fixes only, on a best-effort basis with no release cadence or SLA. "C

Top issues

Discussions

Latest release

v7.11.0 v7.11.0 2026-11-14
Changed

- SAM 3 asks to be downloaded again, as 1.8 GB on a GPU or 3.7 GB on the CPU, and asks again for its CPU files when AI falls back to the CPU. Its files from earlier versions stay on disk. (3099)
- AI no longer retries a request on the CPU when the GPU fails partway through; the next request loads the model again. The status bar no longer shows "Preparing image…". (3100)

 Fixed

- The model menu shows the download size for the AI device: SAM 3 shows about 1.8 GB on a GPU instead of its CPU size. (3104)
- Deleting an AI model no longer freezes the window while AI runs, and other loaded

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON