Skip to content


This tutorial will guide you through the process of downloading one of our freely available OpenVisionCapsule capsules and adding it to BrainFrame. We will be installing our simple face detector capsule that works on all platforms, even those without a GPU.

Downloading the Capsule

On the computer that is hosting the BrainFrame server, navigate to our downloads page and under Capsules, locate the Detector Face Fast entry. Click the link to download the capsule.

Adding the Capsule to BrainFrame

In the server's data directory (/var/local/brainframe by default), there should be a directory called capsules/. If the capsules/ directory does not exist, create it. Place the capsule file that you just downloaded (detector_face_fast.cap) within this directory.

Note: If you do not know the location of BrainFrame's data directory, you can get it directly using the BrainFrame CLI.

mv PATH/TO/detector_face_fast.cap $(brainframe info data_path)/capsules/

An alternative is to download the capsule directly to the capsules/ directory

wget -P $(brainframe info data_path)/capsules {DOWNLOAD_URL}

Verifying That the Capsule Works

The capsule should now be ready for use by BrainFrame. Let's open the client and make sure everything is working properly.

Open the BrainFrame client and then open the Global Capsule Configuration dialog. You should see an entry for the Detector Face Fast capsule, with configuration options.

Once you load a stream, you will be able to see the inference results on the Streams view.