Ubuntu advanced installation - compilation from source files

The easiest way to install Intel® Deep Learning Streamer (Intel® DL Streamer) Pipeline Framework is installing it from pre-built Debian packages. If you would like to follow this way, please go to Install Guide Ubuntu.

The instruction below focuses on installation steps with building Intel® DL Streamer Pipeline Framework from the source code provided in Open Edge Platform repository.

Step 1: Install prerequisites

Please go through prerequisites 1 & 2 described in Install Guide Ubuntu

Step 2: Install build dependencies

Ubuntu 24Ubuntu 22

sudo apt-get update && \
sudo apt-get install -y wget vainfo xz-utils python3-pip python3-gi gcc-multilib libglib2.0-dev \
    flex bison autoconf automake libtool libogg-dev make g++ libva-dev yasm libglx-dev libdrm-dev \
    python-gi-dev python3-dev libtbb12 gpg unzip libopencv-dev libgflags-dev \
    libgirepository1.0-dev libx265-dev libx264-dev libde265-dev gudev-1.0 libusb-1.0 nasm python3-venv \
    libcairo2-dev libxt-dev libgirepository1.0-dev libgles2-mesa-dev wayland-protocols libcurl4-openssl-dev \
    libssh2-1-dev cmake git valgrind numactl libvpx-dev libopus-dev libsrtp2-dev libxv-dev \
    linux-libc-dev libpmix2t64 libhwloc15 libhwloc-plugins libxcb1-dev libx11-xcb-dev

Step 3: Set up a Python environment

Create a Python virtual environment and install required Python packages:

python3 -m venv ~/python3venv
source ~/python3venv/bin/activate

pip install --upgrade pip==24.0
pip install meson==1.4.1 ninja==1.11.1.1

Step 4: Build FFmpeg

Download and build FFmpeg:

mkdir ~/ffmpeg
wget --no-check-certificate https://ffmpeg.org/releases/ffmpeg-6.1.1.tar.gz -O ~/ffmpeg/ffmpeg-6.1.1.tar.gz
tar -xf ~/ffmpeg/ffmpeg-6.1.1.tar.gz -C ~/ffmpeg
rm ~/ffmpeg/ffmpeg-6.1.1.tar.gz

cd ~/ffmpeg/ffmpeg-6.1.1
./configure --enable-pic --enable-shared --enable-static --enable-avfilter --enable-vaapi \
    --extra-cflags="-I/include" --extra-ldflags="-L/lib" --extra-libs=-lpthread --extra-libs=-lm --bindir="/bin"
make -j "$(nproc)"
sudo make install

Step 5: Build GStreamer

Clone and build GStreamer:

cd ~
git clone https://gitlab.freedesktop.org/gstreamer/gstreamer.git

cd ~/gstreamer
git switch -c "1.24.12" "tags/1.24.12"
meson setup -Dexamples=disabled -Dtests=disabled -Dvaapi=enabled -Dgst-examples=disabled --buildtype=release --prefix=/opt/intel/dlstreamer/gstreamer --libdir=lib/ --libexecdir=bin/ build/
ninja -C build
sudo env PATH=~/python3venv/bin:$PATH meson install -C build/

Step 6: Build OpenCV

Download and build OpenCV:

wget --no-check-certificate -O ~/opencv.zip https://github.com/opencv/opencv/archive/4.10.0.zip
unzip ~/opencv.zip -d ~
rm ~/opencv.zip
mv ~/opencv-4.10.0 ~/opencv
mkdir -p ~/opencv/build

cd ~/opencv/build
cmake -DBUILD_TESTS=OFF -DBUILD_PERF_TESTS=OFF -DBUILD_EXAMPLES=OFF -DBUILD_opencv_apps=OFF -GNinja ..
ninja -j "$(nproc)"
sudo env PATH=~/python3venv/bin:$PATH ninja install

Step 7: Clone Intel® DL Streamer repository

cd ~
git clone https://github.com/open-edge-platform/edge-ai-libraries.git
cd edge-ai-libraries
git submodule update --init libraries/dl-streamer/thirdparty/spdlog

Step 8: Install OpenVINO™ Toolkit

Download and install OpenVINO™ Toolkit:

Ubuntu 24Ubuntu 22

cd ~/edge-ai-libraries/libraries/dl-streamer
sudo ./scripts/install_dependencies/install_openvino_ubuntu24.sh

Note

In case of any problems with the installation scripts, Follow OpenVINO™ Toolkit instruction guide here to install OpenVINO™ on Linux.

• Environment: Runtime

• Operating System: Linux

• Version: Latest

• Distribution: OpenVINO™ Archives

After successful OpenVINO™ Toolkit package installation, run the following commands to install OpenVINO™ Toolkit dependencies and enable OpenVINO™ Toolkit development environment:

sudo -E /opt/intel/openvino_2025/install_dependencies/install_openvino_dependencies.sh source /opt/intel/openvino_2025/setupvars.sh

Step 9: Build Intel DLStreamer

cd ~/edge-ai-libraries/libraries/dl-streamer

sudo ./scripts/install_metapublish_dependencies.sh

mkdir build
cd build

export PKG_CONFIG_PATH="/opt/intel/dlstreamer/gstreamer/lib/pkgconfig:${PKG_CONFIG_PATH}"
source /opt/intel/openvino_2025/setupvars.sh

cmake -DENABLE_PAHO_INSTALLATION=ON -DENABLE_RDKAFKA_INSTALLATION=ON -DENABLE_VAAPI=ON -DENABLE_SAMPLES=ON ..
make -j "$(nproc)"

Step 10: Set up environment

Set up the required environment variables:

export LIBVA_DRIVER_NAME=iHD
export GST_PLUGIN_PATH="$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:/usr/lib/x86_64-linux-gnu/gstreamer-1.0"
export LD_LIBRARY_PATH="/opt/intel/dlstreamer/gstreamer/lib:$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib:/usr/lib:$LD_LIBRARY_PATH"
export LIBVA_DRIVERS_PATH="/usr/lib/x86_64-linux-gnu/dri"
export GST_VA_ALL_DRIVERS="1"
export PATH="/opt/intel/dlstreamer/gstreamer/bin:$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/bin:$HOME/.local/bin:$HOME/python3venv/bin:$PATH"
export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib/pkgconfig:/usr/lib/x86_64-linux-gnu/pkgconfig:/opt/intel/dlstreamer/gstreamer/lib/pkgconfig:$PKG_CONFIG_PATH"
export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX

Note

To set up Linux with the relevant environment variables every time a new terminal is opened, open ~/.bashrc and add the above lines

Step 11: Install Python dependencies (optional)

If you intend to use Python elements or samples, you need to install the necessary dependencies using the following commands:

source ~/python3venv/bin/activate
cd ~/edge-ai-libraries/libraries/dl-streamer
python3 -m pip install -r requirements.txt