# AI-assisted pre-labeling

### Description:

You can access the AI-assistant via a tab in your [project](https://docs.datagym.ai/documentation/project/what-is-a-project) detail page. The AI-assistant allows you to automatically add labels to the images in your project based on the **convolutional neural network (CNN)** provided by **DATA**GYM. We offer you 80+ classes (ex., car, person, traffic light, etc.) to detect objects in your images. With a few click you can define which classes you need for your project and the respective labels will be added to your images. Thereby, you can **pre-label** the images to reduce the workload for your team and speed up the overall labeling process. [Here](https://docs.datagym.ai/documentation/ai-assistant/object-classes) you can see the full list of classes supported by our CNN.

{% hint style="info" %}
The AI-Assistant is only available for users with a **Team Pro** subscription. Upgrade your [pricing plan](https://www.datagym.ai/pricing/) to make labeling images even faster! 
{% endhint %}

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-M9SV_D83XxDFLqTv_ZL%2F-M9SVmHvk26FISpKlkif%2Fdg-ai-assistant.png?alt=media\&token=a04a2372-1993-48f4-b6ed-cf5568c4f417)

### Configure a label mapping:

Use the label-mapping table to define which objects you want to pre-label in your project. Therefore, you select a class from our CNN in the first column and a geometry from your [label configuration](https://docs.datagym.ai/documentation/label-configuration/what-is-a-label-configuration) in the second column. Thereby, you can can assign the classes to the objects you want to find in your project. Please note that only [bounding box geometries](https://docs.datagym.ai/documentation/label-configuration/entry-types#available-geometries) can be used for the pre-labeling. 

{% hint style="info" %}
You need at least one bounding box in you label config to configure the pre-labeling functionality.
{% endhint %}

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-M9SV_D83XxDFLqTv_ZL%2F-M9SW_1FjK3kIIQ7AACT%2Fdg-ai-assistant-mapping.png?alt=media\&token=d788ad3d-1e39-4114-a2ac-5f6ca2f7dbae)

You can assign multiple classes to the same label configuration entry. In the example above, the classes `car` and `truck` are both assigned to the `Vehicle` geometry. Thereby, all cars and trucks will be labeled as vehicles in your project.

### Manage the pre-labeling process:

The buttons on top of the page allow you to **start** and **stop** the pre-labeling process. The pre-labeling only considers images in [tasks](https://docs.datagym.ai/documentation/tasks/what-is-a-task) that are in the **WAITING** state. Make sure to move all task from **BACKLOG** to **WAITING** before you start the pre-labeling process. 

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-M9SV_D83XxDFLqTv_ZL%2F-M9SWopocj-rJ50GTi_g%2Fdg-ai-assistant-pre-label-progress-bar.png?alt=media\&token=4143bdde-df49-49ac-9e07-bfd82542b97e)

After starting the process, a progress bar will keep you updated about the number of images that have already been labeled. Use the stop button to cancel the pre-labeling process. You can stop the pre-labeling process at any time and update the label mapping as you like before you continue.

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-M9SV_D83XxDFLqTv_ZL%2F-M9SX00gl9l-rXS2rOJ3%2Fdg-ai-assistant-pre-label-progress-bar-completed.png?alt=media\&token=7b726ece-e0ec-4ed1-842c-7915cea81c45)

After the pre-label process finished, you can see the total number of images/tasks in your project that were labeled.

{% hint style="info" %}
Please note that tasks in your project are pre-labeled only once. You have to add or reconnect a specific dataset to start a new pre-labeling for the corresponding tasks.
{% endhint %}

### Pre-labeled images:

If an image was pre-labeled it is marked with a light-blue clipboard icon as shown in the image.

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-MC7MZx5gviqCEnMvlGs%2F-MC7NN38yqu7T1k8cwYf%2FBildschirmfoto%202020-07-13%20um%2015.33.23.png?alt=media\&token=a31ea094-54e9-4870-84c6-404b8a23ee91)

### AI-assistance limit:

Pre-labeling counts towards the AI-assistance limit of your pricing plan. For every pre-labeled image your remaining AI-assistance limit for this month will be reduced by one. If you try to label more images than you have Ai-assistance remaining you will be notified and can stop the process to reconsider the images you want to pre-label.

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-MC6xM4hMJgBQO363gnM%2F-MC6yYwMbwZ_fQ6EVuw3%2FBildschirmfoto%202020-07-13%20um%2013.25.37.png?alt=media\&token=bf10ea1c-46f3-43da-a85c-b17beb1b0473)

If your remaining AI-assistance reaches zero, the start button is disabled and you won't be able to further pre-label images.

![](https://622290927-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LzaIa2HtqaLgqpL5TFA%2F-MC6xM4hMJgBQO363gnM%2F-MC6ypAiE09EXTwFYmmc%2FBildschirmfoto%202020-07-13%20um%2012.59.19.png?alt=media\&token=161a8802-311c-4dcf-ab5f-3b58af419e19)