Create and configure projects
All labeling activities in Label Studio occur in the context of a project.
Project setup workflow
After you start Label Studio and create an account, create a project to start labeling your data.
Import data into Label Studio.
For small projects, testing, or proof of concept work, you can import local files directly into Label Studio. However, for larger projects, we recommend setting up cloud storage. For more information, see Get data into Label Studio and Sync data from external storage.
After you have imported your data, then you can set up the labeling interface for your project.
Finally, you can configure optional settings to such as task sampling and annotation instructions. For more information, see Project settings.
Create a project
From Label Studio, click Create Project in the upper right. A window opens with three tabs:
- Project Name
-
This is the only required section.
Here, select your workspace, enter a project name, and (optionally) a project description.
Once complete, you can click Save to create the project, or you can complete the other tabs.
- Data Import
-
From here, you can upload files into Label Studio. You can do this now or after the project has been created.
However, for larger projects, we recommend setting up cloud storage or using a different import method. For more information, see Get data into Label Studio and Sync data from external storage.
- Labeling Setup
-
You can select a template to begin your labeling configuration. For easier setup, select a template. You can later customize template to meet your needs. See Configure labeling.
You can do this now or after the project has been created.
When you’re done, click Save.
Enterprise
Workspaces are only available for Label Studio Enterprise users. Label Studio Enterprise also includes many additional configuration options for projects, such as role-based access control and workflow automation. For more information, see Compare Community and Enterprise Features.
Set up annotation settings for your project
There are several things you can set up before users begin labeling:
Instructions for data labelers
You also can select whether to show these instructions in a pop-up message when users enter the labeling stream (the labeling stream is when a user clicks Label All Tasks).
-
Task sampling determines the order in which tasks are shown to users in the labeling stream. The default is to use sequential sampling, meaning the users see them in the same order they are sorted in the Data Manager. You can change this to show tasks in random order.
From the Data Manager, click Settings in the upper right. You can also access the settings from the overflow menu for each project:
For information on all available settings, see Project settings.
Where Label Studio stores your project data and configurations
All labeling activities in Label Studio occur in the context of a project.
Starting in version 1.0.0, Label Studio stores your project data and configurations in a SQLite database. You can choose to use PostgreSQL instead. See Set up database storage.
In versions of Label Studio earlier than 1.0.0, when you start Label Studio for the first time, it launches from a project directory that Label Studio creates, called ./my_project by default.
label-studio start ./my_project --init