labelu 1.4.1

No project description provided

English | 简体中文

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.

AI Auto-Annotation

LabelU integrates AI model services for automatic annotation of image data. Click the "AI Annotate" button on the annotation page to have the model automatically detect and segment objects. Supports batch annotation for entire tasks with real-time progress tracking. Three reference model servers are provided out of the box:

• Florence-2 — lightweight, CPU-friendly (~4GB VRAM)
• GroundingDINO + EfficientSAM — high-quality detection + segmentation (~4GB VRAM)
• SAM 3 — state-of-the-art unified model (~8GB VRAM, requires high-end GPU)

See model_server/README.md for setup instructions.

S3 Data Source Import

LabelU supports importing annotation data directly from S3-compatible object storage (AWS S3, MinIO, etc.). Configure data source connections in the task settings, browse and preview files, then import selected files or all files under a path with one click.

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

• Try LabelU annotation toolkit

• Try LabelU online

Local deployment

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

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

3. Activate the environment：

conda activate labelu

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

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

6. 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！

Links

• LabelU-kit Web front-end annotation kit (LabelU is based on this JavaScript kit)
• LabelLLM An Open-source LLM Dialogue Annotation Platform
• Miner U A One-stop Open-source High-quality Data Extraction Tool

License

This project is released under the Apache 2.0 license.