JeVois Tutorials  1.5
JeVois Smart Embedded Machine Vision Tutorials
Share this page:
Setting up for programming JeVois

This tutorial will help you get setup for programming JeVois.

If all you want to do is use existing bundled machine vision algorithms, and possibly develop new modules in Python only, then simply get and flash a microSD image from and check out:

The programming environment is Ubuntu 64-bit, version 17.04 (zesty) or 16.04 LTS (xenial).

It is generally ok to setup the programming environment in a virtual machine (e.g., VirtualBox). Just beware that you may have to resolve issues having to do with granting proper access to either the video camera or the microSD card to the virtual machine. See Using Virtualbox to setup jevois-sdk in a virtual machine for more info.


When upgrading to a new version of JeVois (for example, from 1.1 to 1.2), we recommend deleting all previous generated files and rebuilding both /jevois for host and the staging area for platform in var/lib/jevois-build and /var/lib/jevois-microsd as follows:

sudo rm -rf /jevois /usr/lib/jevois-build/usr /var/lib/jevois-microsd

Then rebuild everything (except the Linux kernel, platform O.S., etc) as detailed below.

If upgrading from version 1.0, you need to delete the files that were installed in different locations:
  • remove all OpenCV files in /usr/local/include/opencv*, /usr/local/lib/libopencv*, /usr/local/share/opencv
  • remove JeVois files /usr/bin/jevois*
  • remove JeVois libraries /usr/lib/libjevois*
  • remove /jevois

To upgrade previously installed JeVois Debian packages (jevois-sdk-dev and dependencies), do as follows:

sudo apt update
sudo apt upgrade

Installing Debian packages the first time

Getting the latest source code from GitHub

git clone
git clone
git clone
git clone
git clone
git clone
If upgrading, cd to each directory instead and run a git pull command to bring your copy up to date with the master repository.

Before compiling for the first time: Getting the contributed packages

This step is automatic as of JeVois v1.5 and can be skipped for that version and later.

The directory jevoisbase/Contrib is for a collection of contributed source code packages.

Before you attempt to compile jevoisbase the first time, you should download and patch those contributed packages, as follows:

cd ~/jevoisbase/Contrib

Compiling JeVois, JeVoisBase, samplemodule

If you recompile jevois and jevoisbase from the latest version from GitHub, then you should also flash those versions to microSD before you proceed with compiling and installing your own modules to microSD. Otherwise, you may end up with older versions of jevois and jevoisbase on your microSD (if it was installed from a microSD image from which may not work with your new module compiled against the latest version of jevois from GitHub. See Flashing to microSD card for details, especially the section: Pulling the latest from github and re-flashing - full recompilation.