Skip to main content
Version: 2.4.0 (latest)



  1. Set up the execution permission for the installer before running:
  • Go to the directory, where OMNI Agent installer is downloaded to, and click the right button on the installation file.
  • Open Properties, go to the Permission tab, and check Allow execute checkbox.
  1. Install (for Standalone mode only)
Before installing OMNI Agent for the ARMv8 platform, install the Qt5 library packages using the command:
apt-get update && apt-get install -y libqt5gui5 libqt5qml5 libqt5xml5 libqt5widgets5


Installation with GUI

  1. Download OMNI Agent installer from the distribution kit.
  2. Once the downloading is completed, run the OMNI Agent installer and follow the installation wizard's instructions.

Installation without GUI (only for Linux/Windows)

For installation on Linux

Install the following GUI libraries: libxrender1, libx11-xcb-dev, libxkbcommon-x11-0, libfontconfig1, fontconfig, libfontconfig1-dev.

  1. Download the OMNI Agent installer from the distribution kit.

  2. Run the installer.

path to the installer install

If you receive any warnings/errors that mention the Desktop folder, ignore them (type Ignore).

For additional information, pass the --help flag.


OMNI Agent (Standalone)

  1. Run OMNI Agent.

  2. Select a Standalone license and upload/drag a license file.

  3. Click Save. This will take you to the main page of OMNI Agent web interface.

OMNI Agent (Online)

  1. Run OMNI Agent.
  2. On the opened web page, select an Online license, upload/drag a license file and click Next.
  3. Select "Self-hosted", put the server domain and click on Next button. The domain is specified in the platform.values.yaml of OMNI Platform distribution kit in the field
  4. Sign in to OMNI Agent using the email and password of your OMNI Platform account. This data is specified in ./cfg/platform.secrets.json in variables platform-user-secret.default_password and platform-user-secret.default_email.
  5. This will take you to the main page of OMNI Agent web interface.

Adding a Camera

  • To use an IP camera, enter the camera URL.
  • To use a USB camera, connect the camera to your machine and select it from the list of connected cameras.



When choosing a camera, try to consider the following:

  • The main flow of people should go directly to the camera, and not perpendicular to it.
  • The light source should be behind the camera, so that faces are not shadowed in bright light.

Learn more about choosing cameras

Camera Preview

After a camera is successfully added, OMNI Agent web interface will display preview from the camera, detections (bboxes) of faces and silhouettes and additional information about people in the camera's field of view: their gender, age, emotions, etc.


The detected faces and silhouettes are highlighted as follows:

face bbox:

  • bbox with red corners: a face is detected but the person’s attention is none;
  • bbox with white corners: both a face and the person’s attention are detected;
  • bbox with corners of + form: image quality is insufficient or head rotation angle is not applicable for proper detection;
  • bbox with green corners: a face is detected and recognized but the person attention is not registered;
  • bbox with orange corners: a face is detected and recognized, and the person's attention is registered.

body bbox:

  • green bounding box: a human silhouette is detected and has an ID;
  • red bounding box: a human silhouette is detected, but an ID is not assigned yet.

Body re-identification is not available in the build for ARMv8: silhouettes are detected, displayed, but not tracked.

Configure OMNI Agent as a Linux/Windows service

After installation, you can configure OMNI Agent to operate as the OS service. This will ensure that OMNI Agent starts up automatically when the OS starts, and runs in the background.


  1. Close the terminal with OMNI Agent.

  2. Enable autorun of OMNI Agent when the OS starts.

    systemctl enable OMNIAgent
  3. Start OMNI Agent in service mode.

    systemctl start OMNIAgent
  4. Check OMNI Agent status.

    systemctl status OMNIAgent


  1. Close the terminal with OMNI Agent.

  2. Open Windows Task Manager -> Services -> OMNIAgent.

  3. Right-click on the OMNIAgent service, select Properties -> General -> Startup Type -> Automatic.

  4. Click Apply.