Welcome to new site for BeagleBoard.org docs!

Running Simple demos#

This chapter describes how to run Python and C++ demo applications in edge_ai_apps with live camera and display.


Please note that the Python demos are useful for quick prototyping while C++ demos are similar by design but tuned for performance.

Running Python based demo applications#

Python based demos are simple executable scripts written for image classification, object detection and semantic segmentation. Demos are configured using a YAML file. Details on configuration file parameters can be found in Demo Configuration file

Sample configuration files for out of the box demos can be found in edge_ai_apps/configs this folder also contains a template config file which has brief info on each configurable parameter edge_ai_apps/configs/app_config_template.yaml

Here is how a Python based image classification demo can be run,

1# go to edge-ai-apps folder
2debian@beaglebone:~$ cd /opt/edge_ai_apps/apps_python
4# enable root (password: temppwd)
5debian@beaglebone:~$ sudo su
6[sudo] password for beaglebone:
8# use edge-ai-apps
9debian@beaglebone:/opt/edge_ai_apps/apps_cpp# sudo ./app_edgeai.py ../configs/image_classification.yaml

The demo captures the input frames from connected USB camera and passes through pre-processing, inference and post-processing before sent to display. Sample output for image classification and object detection demos are as below,



To exit the demo press Ctrl+C.

Building and running C++ based demo applications#

C++ apps needs to be built directly on target and requires header files of different deep-learning runtime framework and its dependencies which are installed in the setup script. The setup script builds the C++ apps when executed. However one can also follow below steps to clean build C++ apps

debian@beaglebone:/opt/edge_ai_apps/apps_cpp# rm -rf build bin lib
debian@beaglebone:/opt/edge_ai_apps/apps_cpp# mkdir build
debian@beaglebone:/opt/edge_ai_apps/apps_cpp# cd build
debian@beaglebone:/opt/edge_ai_apps/apps_cpp/build# cmake ..
debian@beaglebone:/opt/edge_ai_apps/apps_cpp/build# make -j2

Run the demo once the application is successfully built

debian@beaglebone:/opt/edge_ai_apps/apps_cpp# ./bin/Release/app_edgeai ../configs/image_classification.yaml

To exit the demo press Ctrl+C.


Both Python and C++ applications are similar by construction and can accept the same config file and command line arguments


The C++ apps built on Yocto Linux may not run in Docker as there could be a mismatch in Glib and other related tools. So its highly recommended to rebuild the C++ apps within the Docker environment.