Skip to content
NanoNets Object Detection API Example for Python
Branch: master
Clone or download
Latest commit 4156978 Feb 7, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
annotations Initial Commit Feb 19, 2018
images Initial Commit Feb 19, 2018
notebooks fixing the markdown for header Jan 21, 2019
.gitignore Initial Commit Feb 19, 2018

NanoNets Object Detection Python Sample

Golang Sample Python Sample Node.js Sample PHP Sample

Tracking the Millenium Falcon

Images and annotations taken from -

Images consists of frames taken from a clip from Star Wars: The Force Awakens. Watch the video

Annotations are present for each frame and have the same name as the image name. You can find the example to train a model in python and node, by updating the api-key and model id in corresponding file. There is also a pre-processed json annotations folder that are ready payload for nanonets api.

Build an Object Detector for the Millenium Falcon

Note: Make sure you have python and pip installed on your system if you don't visit Python pip

Step 1: Clone the Repo, Install dependencies

git clone
cd object-detection-sample-python
sudo pip install requests tqdm

Step 2: Get your free API Key

Get your free API Key from

Step 3: Set the API key as an Environment Variable


Step 4: Create a New Model

python ./code/

_Note: This generates a MODEL_ID that you need for the next step

Step 5: Add Model Id as Environment Variable


_Note: you will get YOUR_MODEL_ID from the previous step

Step 6: Upload the Training Data

The training data is found in images (image files) and annotations (annotations for the image files)

python ./code/

Step 7: Train Model

Once the Images have been uploaded, begin training the Model

python ./code/

Step 8: Get Model State

The model takes ~2 hours to train. You will get an email once the model is trained. In the meanwhile you check the state of the model

python ./code/

Step 9: Make Prediction

Once the model is trained. You can make predictions using the model

python ./code/ PATH_TO_YOUR_IMAGE.jpg

Sample Usage:

python ./code/ ./images/videoplayback0051.jpg

Note the python sample uses the converted json instead of the xml payload for convenience purposes, hence it has no dependencies.

You can’t perform that action at this time.