HOW TO GUIDE

Use DETIC to train a DETR Object Detection model

Before you can train a computer vision model, you need labeled data on which to train your model. The more accurate the labels, or annotations, are, the higher the performance the model will achieve.

Get started for free

Overview

Autodistill allows you to use state-of-the-art foundation models that know a lot about a variety of objects to label data for your project. You can then train a new model with your labeled data. This whole process uses around a dozen lines of code.

To learn more about how autodistill works, read our overview guide or watch our YouTube tutorial.

In this guide, we will show you how to use

DETIC

to train a

DETR

model.

To label data for a DETR model with DETIC, you will:

Install Autodistill
Create a dataset
Build a prompt to label images in the dataset
Label our data on Autodistill
Train a new model
(Optional) Train a model or export your data

Let's get started!

Step 1

Install Dependencies

First, install Autodistill and the required model dependencies:

pip install autodistill autodistill-detr autodistill-detic supervision

Step 2

Create a Dataset

Before you can label a dataset, you need a dataset with which to work.

Roboflow has a few resources that can help you create a dataset for your project:

Roboflow Collect: Collect images in the background for use in your project.
Roboflow Universe: Collect images from datasets made by the Roboflow community.

You can use any folder of images you have on your local machine with Autodistill, too.

Step 3

Label Images

Autodistill has two model types:

A Base Model, which automatically labels your data, and;
A Target Model, which trains on your labeled data.

To label your dataset with a Base Model, you need to provide prompt(s) that are relevant to the classes you want to label.

Replace "example" below with the prompt you want to use. Replace "class" with the name of the class you want the prompt results to be saved as in your dataset. Also, replace the IMAGE_NAME with an image from your dataset.

The code cell below loads the base model with your prompt on the provided image, then visualizes the results.

You may need to experiment with a few prompts.


from autodistill_detic import DETIC
from autodistill.detection import CaptionOntology

base_model = DETIC(ontology=CaptionOntology({"shipping container": "container"}))

IMAGE_NAME = "valid/images/image.jpg"

image = os.path.join(DATASET_NAME, IMAGE_NAME)

predictions = base_model.predict(image)

image = cv2.imread(image)

annotator = sv.BoxAnnotator()

annotated_image = annotator.annotate(scene=image, detections=predictions)

sv.plot_image(annotated_image)

To start labeling your images, run the following code:

base_model.label(input_folder="./images", output_folder="./dataset")

Step 4

Train a Model

To train a

DETR

model using your newly-labeled dataset, run the following code:
‍


from autodistill_detr import DETR

target_model = DETR()

# train a model
target_model.train("./context_images_labeled", epochs=20)

# run inference on the new model
pred = target_model.predict("./context_images_labeled/train/images/image.jpg", confidence=0.5)

After running this cell, you will have model weights that you can use to run inference on your new model.

Step 5

Upload Model to Roboflow (Optional)

You can deploy your trained model to Roboflow. By deploying your model to Roboflow, you can run inference on our infinitely-scalable API. As your inference demands grow, our you will continue to see high levels of performance thanks to autoscaling infrastructure that is always on.

Roboflow offers:

Fully managed, infinitely-scalable APIs for deployed models

SDKs for common deployment targets (NVIDIA Jetson, Luxonis OAK, Docker, and more)

SOC II Type 1 Compliant

Trusted by 250,000+ developers

To deploy your model to Roboflow, run the following code: