First steps with DepthAI¶
This guide will go through the first steps with OAK camera and DepthAI library:
Device setup - connecting the OAK camera to your (host) computer
Running DepthAI Viewer, the visualization GUI app for DepthAI
Next steps; examples, demos, API docs
Follow instructions below to install DepthAI and its dependencies/requirements with an installer.
If you would like to avoid using installer and would prefer manually installing dependencies, requirements and DepthAI, see Manual DepthAI installation.
Now that we have installed requirements, we can setup the device. OAK cameras can be separated into two categories depending on how you connect to them; either via ethernet (OAK PoE cameras) or via USB (all others).
After the installer finishes, you can run the DepthAI Viewer by running:
python3 -m depthai_viewer
Running the Viewer for the first time, the app will download a default mobilenet-ssd model, configure the OAK camera and then show default streams from the camera.
While the Viewer is running, you can see detection results, and if you are standing in front of the camera, you should see yourself detected as a person with a high probability.
The model that is used by default is a MobileNetv2 SSD object detector trained on the PASCAL 2007 VOC classes, which are:
Animal: bird, cat, cow, dog, horse, sheep
Vehicle: airplane, bicycle, boat, bus, car, motorbike, train
Indoor: bottle, chair, dining table, potted plant, sofa, TV/monitor
So give it a try to detect different objects, like bottles or apples
In the previous sections, we learned how to preview basic DepthAI features. From this point, you can explore the DepthAI world further
Check our Example Use Cases for ready to use applications that solve a specific problem on DepthAI
Getting started with coding
Be sure to check hello world tutorial on API section for a step-by-step introduction to the API
Train and deploy a custom model to OAK
Visit Custom training page for ready to use Colab notebooks
Already built apps for OAK devices
See luxonis/depthai-experiments repository for apps built with depthai library
Depthai API library repository