Build from Source#

This guide provides step-by-step instructions for building Live Video Alert Agent Sample Application from source.

Building the Images#

To build the Docker image for Live Video Alert Agent application, follow these steps:

  1. Ensure you are in the project directory:

    cd edge-ai-suites/metro-ai-suite/live-video-analysis/live-video-alert-agent

  2. (Optional) To include third-party copyleft source packages in the image, export the environment variable before building:

    export COPYLEFT_SOURCES=true

  3. Run the following docker compose command:

    docker compose -f docker/docker-compose.yml build

Run the Application#

  • Run the application using the following command:

    docker compose -f docker/docker-compose.yml up

  • For NPU deployments, include the NPU override file:

    export OVMS_TARGET_DEVICE=NPU
docker compose -f docker/docker-compose.yml -f docker/docker-compose.npu.yml up

    You can also run a mixed configuration (for example, GPU for VLM and NPU for LLM):

    export VLM_TARGET_DEVICE=GPU
export LLM_TARGET_DEVICE=NPU
docker compose -f docker/docker-compose.yml -f docker/docker-compose.npu.yml up

  • Ensure that the application is running by checking the container status:

    docker ps

  • Access the application by opening your web browser and navigate to http://localhost:9000 to view the dashboard UI.

  • (Optional) To force a clean rebuild run the following:

    docker compose -f docker/docker-compose.yml up --build

Notes:

  • The default port is 9000, but can be changed in the compose yaml.

  • Use pre-converted OpenVINO IR models from the OpenVINO organization on Hugging Face for best compatibility. These models are optimized for OVMS and require no additional conversion.