<div align="center"> <article style="display: flex; flex-direction: column; align-items: center; justify-content: center;"> <p align="center"><img width="300" src="https://user-images.githubusercontent.com/25022954/209616423-9ab056be-5d62-4eeb-b91d-3b20f64cfcf8.svg" /></p> <h1 style="width: 100%; text-align: center;"></h1> <p align="center"> English | <a href="./README_zh-CN.md" >简体中文</a> </p> </article> </div>

Product Introduction

LabelU is a comprehensive data annotation platform designed for handling multimodal data. It offers a range of advanced annotation tools and efficient workflows, making it easier for users to tackle annotation tasks involving images, videos, and audio. LabelU is tailored to meet the demands of complex data analysis and model training.

Key Features

Versatile Image Annotation Tools

LabelU provides a comprehensive set of tools for image annotation, including 2D bounding boxes, semantic segmentation, polylines, and keypoints. These tools can flexibly address a variety of image processing tasks, such as object detection, scene analysis, image recognition, and machine translation, helping users efficiently identify, annotate, and analyze images.

Powerful Video Annotation Capabilities

In the realm of video annotation, LabelU showcases impressive processing capabilities, supporting video segmentation, video classification, and video information extraction. It is highly suitable for applications such as video retrieval, video summarization, and action recognition, enabling users to easily handle long-duration videos, accurately extract key information, and support complex scene analysis, providing high-quality annotated data for subsequent model training.

Efficient Audio Annotation Tools

Audio annotation tools are another key feature of LabelU. These tools possess efficient and precise audio analysis capabilities, supporting audio segmentation, audio classification, and audio information extraction. By visualizing complex sound information, LabelU simplifies the audio data processing workflow, aiding in the development of more accurate models.

Artificial Intelligence Assisted Labelling

LabelU supports one-click loading of pre-annotated data, which can be refined and adjusted according to actual needs. This feature improves the efficiency and accuracy of annotation.

https://github.com/user-attachments/assets/0fa5bc39-20ba-46b6-9839-379a49f692cf

Features

Simplicity: Provides a variety of image annotation tools that can be annotated through simple visual configuration.
Flexibility: A variety of tools can be freely combined to meet most image, video, and audio annotation needs.
Universality: Supports exporting to various data formats, including JSON, COCO, MASK.

Getting started

<a href="https://opendatalab.github.io/labelU-Kit/"> <button>Try LabelU annotation toolkit</button>

</a>

<a href="https://labelu.shlab.tech/"> <button>Try LabelU online</button>

</a>

Local deployment

Install Miniconda, Choose the corresponding operating system type and download it for installation.

Note： If your system is MacOS with an Intel chip, please install Miniconda of intel x86_64.

After the installation is complete, run the following command in the terminal (you can choose the default 'y' for prompts during the process):

conda create -n labelu python=3.11

Note： For Windows platform, you can run the above command in Anaconda Prompt.

Activate the environment：

conda activate labelu

Install LabelU：

pip install labelu

To install the test version：pip install labelu==<test revision>

Install labelu with MySQL support：

pip install labelu[mysql]

# Or install labelu and mysqlclient separately
# pip install labelu mysqlclient

Run LabelU：

labelu

If you need to use MySQL database after upgrading from version 1.x, run the following command to migrate data from the built-in SQLite database to the MySQL database:

DATABASE_URL=mysql://<username>:<password>@<host>/<your dbname> labelu migrate_to_mysql

Visit http://localhost:8000/ and ready to go.

Local development

# Install uv
# https://docs.astral.sh/uv/getting-started/installation/

# Clone the repository
git clone https://github.com/opendatalab/labelU.git
cd labelU

# Create virtual environment and install all dependencies (Python >= 3.11)
uv sync

# Copy the example environment file and configure it
cp .env.example .env
# Edit .env and set your values:
#   PASSWORD_SECRET_KEY  - JWT secret key, generate with: openssl rand -hex 32
#   MEDIA_HOST           - Media server URL (default: http://localhost:8000)
#   DATABASE_URL         - Database connection URL (default: sqlite:///data/labelu.sqlite)

# Download the frontend statics from labelu-kit repo
sh ./scripts/resolve_frontend.sh true

# Start labelu, server: http://localhost:8000
uv run uvicorn labelu.main:app --reload

Quick start

Guidance

Annotation format

Documentation

Citation

@article{he2024opendatalab,
  title={Opendatalab: Empowering general artificial intelligence with open datasets},
  author={He, Conghui and Li, Wei and Jin, Zhenjiang and Xu, Chao and Wang, Bin and Lin, Dahua},
  journal={arXiv preprint arXiv:2407.13773},
  year={2024}
}

Communication

Welcome to the OpenDataLab official WeChat group！

License

This project is released under the Apache 2.0 license.

LabelU

Install / Use

README