Object Detection API with TensorFlow 1

Requirements

Installation

You can install the TensorFlow Object Detection API either with Python Package Installer (pip) or Docker. For local runs we recommend using Docker and for Google Cloud runs we recommend using pip.

Clone the TensorFlow Models repository and proceed to one of the installation options.

git clone https://github.com/tensorflow/models.git

Docker Installation

# From the root of the git repository
docker build -f research/object_detection/dockerfiles/tf1/Dockerfile -t od .
docker run -it od

Python Package Installation

cd models/research
# Compile protos.
protoc object_detection/protos/*.proto --python_out=.
# Install TensorFlow Object Detection API.
cp object_detection/packages/tf1/setup.py .
python -m pip install --use-feature=2020-resolver .

# Test the installation.
python object_detection/builders/model_builder_tf1_test.py

Quick Start

Colabs

• Jupyter notebook for off-the-shelf inference
• Training a pet detector

Training and Evaluation

To train and evaluate your models either locally or on Google Cloud see instructions.

Model Zoo

We provide a large collection of models that are trained on several datasets in the Model Zoo.

Guides

• <a href='configuring_jobs.md'> Configuring an object detection pipeline</a>

• <a href='preparing_inputs.md'>Preparing inputs</a>

• <a href='defining_your_own_model.md'> Defining your own model architecture</a>
• <a href='using_your_own_dataset.md'> Bringing in your own dataset</a>
• <a href='evaluation_protocols.md'> Supported object detection evaluation protocols</a>
• <a href='tpu_compatibility.md'> TPU compatible detection pipelines</a>
• <a href='tf1_training_and_evaluation.md'> Training and evaluation guide (CPU, GPU, or TPU)</a>

Extras:

• <a href='exporting_models.md'> Exporting a trained model for inference</a>
• <a href='tpu_exporters.md'> Exporting a trained model for TPU inference</a>
• <a href='oid_inference_and_evaluation.md'> Inference and evaluation on the Open Images dataset</a>
• <a href='instance_segmentation.md'> Run an instance segmentation model</a>
• <a href='challenge_evaluation.md'> Run the evaluation for the Open Images Challenge 2018/2019</a>
• <a href='running_on_mobile_tensorflowlite.md'> Running object detection on mobile devices with TensorFlow Lite</a>
• <a href='context_rcnn.md'> Context R-CNN documentation for data preparation, training, and export</a>