Skip to main content

Label Studio annotation tool

Project description

GitHub label-studio:build code-coverage GitHub release

WebsiteDocsTwitterJoin Slack Community

What is Label Studio?

Label Studio is an open source data labeling tool. It lets you label data types like audio, text, images, videos, and time series with a straightforward interface and standardized output formats.

Gif of Label Studio annotating different types of data

Have a custom dataset? You can customize Label Studio to fit your needs. Read an introductory blog post to learn more.

Try out Label Studio

Try out Label Studio in a running app, install it locally, or deploy it in a cloud instance.

Install locally with Docker

Run Label Studio in a Docker container and access it at http://localhost:8080.

docker run --rm -p 8080:8080 -v `pwd`/my_project:/label-studio/my_project --name label-studio heartexlabs/label-studio:latest label-studio start my_project --init

Override default Docker install

By default, the default Docker install command creates a blank project in a ./my_project directory. If the ./my_project folder already exists, Label Studio fails to start. Rename or delete the folder, or use the --force argument to force Label Studio to start:

docker run -p 8080:8080 -v `pwd`/my_project:/label-studio/my_project --name label-studio heartexlabs/label-studio:latest label-studio start my_project --init --force --template text_classification

Build a local image with Docker

If you want to build a local image, run:

docker build -t heartexlabs/label-studio:latest .

Run with Docker Compose

Use Docker Compose to serve Label Studio at http://localhost:8080.

Run this command the first time you run Label Studio:

INIT_COMMAND='--init' docker-compose up -d

Start Label Studio after you have an existing project:

docker-compose up -d

Start Label Studio and reset all project data:

INIT_COMMAND='--init --force' docker-compose up -d

You can also set environment variables in the .env file instead of specifying INIT_COMMAND. For example, add this line have the option to reset all project data when starting Label Studio:

INIT_COMMAND=--init --force

Install locally with pip

# Requires >=Python3.5, Python 3.9 is not yet supported
pip install label-studio

# Initialize the project in labeling_project path
label-studio init labeling_project

# Start the server at http://localhost:8080
label-studio start labeling_project

Install locally with Anaconda

conda create --name label-studio python=3.8
conda activate label-studio
pip install label-studio

Install for local development

You can run the latest Label Studio version locally without installing the package with pip.

# Install all package dependencies
pip install -e .
# Start the server at http://localhost:8080
python label_studio/ start labeling_project --init

Deploy in a cloud instance

You can deploy Label Studio with one click in Heroku, Microsoft Azure, or Google Cloud Platform:

Troubleshoot installation

If you see any errors during installation, try to rerun the installation

pip install --ignore-installed label-studio

Install dependencies on Windows

To run Label Studio on Windows, download and install the following wheel packages from Gohlke builds to ensure you're using the correct version of python:

# Upgrade pip 
pip install -U pip

# If you're running Win64 with Python 3.8, install the packages downloaded from Gohlke:
pip install lxml‑4.5.0‑cp38‑cp38‑win_amd64.whl

# Install label studio
pip install label-studio

What you get from Label Studio

When you use Label Studio to annotate and label your data, you get a lot of functionality and flexibility.

  • Streamlined design helps you focus on your task, not how to use the software.
  • Configurable label formats let you customize the visual interface to meet your specific labeling needs.
  • Support for multiple data types including images, audio, text, HTML, time-series, and video.
  • Import from files or from cloud storage in Amazon AWS S3, Google Cloud Storage, or JSON, CSV, TSV, RAR, and ZIP archives.
  • Multiple device support with a flexible interface supported on devices of different sizes, from smartphones and tablets to large monitors.
  • Integration with machine learning models so that you can visualize and compare predictions from different models and perform pre-labeling.
  • Embed it in your existing tools so that you don't have to change your workflow to start using Label Studio. The frontend is available as an NPM package.

Screenshot of Label Studio data manager grid view with images

Included templates for labeling data in Label Studio

Label Studio includes a variety of templates to help you label your data, or you can contribute your own. The most common templates and use cases for labeling include the following tasks:

Task Description
Classification Categorize images
Object Detection Identify objects in an image using a bounding box or polygons
Semantic Segmentation Detect the object category for each pixel in an image
Pose Estimation Mark the positions of a person’s joints
Classification Categorize the content or sentiment of text
Summarization Create a summary that represents the most relevant information within the original content
HTML Tagging Annotate things like webpages, as well as resumes, research, legal papers, and spreadsheets converted to HTML
Named Entity Recognition Annotate specific portions of text
Classification Categorize audio content
Speaker Diarisation Partition an audio stream into homogeneous segments according to the speaker identity
Emotion Recognition Tag and identify the emotion in the audio
Transcription Convert the speech in the audio to text
Classification Put videos into categories
Pairwise Comparing entities in pairs to judge which of each entity is preferred
Ranking Sort items in the list according to some property
Time Series
Classification Categorize the types of events occurring over time
Segmentation Separate the portions of a time series event in a useful way

Set up machine learning models with Label Studio

Connect your favorite machine learning framework using the Label Studio Machine Learning SDK. Follow these steps:

  1. Start your own machine learning backend server. See more detailed instructions,
  2. Connect Label Studio to the running machine learning backend on the /model page in Label Studio.
  • Pre-label your data using model predictions.
  • Automatically annotate your data.
  • Do online learning and retrain your model while new annotations are being created.
  • Do active learning by labeling only the most complex examples in your data.
  • Set up a prediction service that is ready for production.

Integrate Label Studio with your existing tools

You can use Label Studio as an independent part of your machine learning workflow or integrate the frontend or backend into your existing tools.


Project Description
label-studio Server, distributed as a pip package
label-studio-frontend React and JavaScript frontend and can run standalone in a web browser or be embedded into your application.
data-manager React and JavaScript frontend for managing data. Includes the Label Studio Frontend. Relies on the label-studio server or a custom backend with the expected API methods.
label-studio-converter Encode labels in the format of your favorite machine learning library
label-studio-transformers Transformers library connected and configured for use with Label Studio


@misc{Label Studio,
  title={{Label Studio}: Data labeling software},
  note={Open source software available from},
    Maxim Tkachenko and
    Mikhail Malyuk and
    Nikita Shevchenko and
    Andrey Holmanyuk and
    Nikolai Liubimov},


This software is licensed under the Apache 2.0 LICENSE © Heartex. 2020-2021

Project details

Release history Release notifications | RSS feed

Download files

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

Files for label-studio, version 0.9.1.post1
Filename, size File type Python version Upload date Hashes
Filename, size label_studio-0.9.1.post1-py3-none-any.whl (13.5 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size label-studio-0.9.1.post1.tar.gz (13.4 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page