System Requirements#

Hardware Requirements#

  • CPU: x86_64. Intel Core Ultra (Meteor Lake) or newer is recommended. Older Intel Core / Xeon processors will run the service but may be slower when the optional behavioral-analysis path is enabled.

  • Memory: 4 GB RAM minimum for the service itself. 8 GB or more is recommended when many concurrent person sessions are tracked.

  • Disk: 5 GB free space for the image and logs. Evidence frames are stored in SeaweedFS (a separate service), not on the service’s local disk.

  • GPU: Not required by this service. The optional behavioral-analysis worker (pose + VLM) is a separate microservice that may use a GPU.

Device

Minimum

Recommended

CPU

x86_64

Intel Core Ultra (Meteor Lake) or newer

Memory

4 GB RAM

8 GB RAM or more

Disk

5 GB free

SSD/NVMe

GPU

Not needed

Used only by the separate BA worker

Software Requirements#

Operating System#

  • Ubuntu 22.04 LTS (validated) or a compatible Linux distribution.

  • For container deployment: Docker Engine and Docker Compose v2.

Python (Standalone Run)#

  • Python 3.11 or newer.

  • uv package manager (used to create the virtual environment and install dependencies from pyproject.toml).

External Dependencies#

The service is an event consumer/producer and depends on external infrastructure at runtime:

Dependency

Required?

Purpose

Scenescape MQTT broker

Yes (functional)

Source of all person and zone events.

Scenescape REST API

Yes (functional)

Zone auto-discovery (zone name → UUID).

SeaweedFS

Only if BA rules used

Evidence frame storage for escalation.

behavioral-analysis

Only if BA rules used

Pose + VLM analysis over MQTT.

alert-service

Optional

Routes/delivers generated alerts.

The service starts and serves its API even when these are unavailable; it retries the MQTT connection in the background. It only produces meaningful output once a Scenescape deployment is reachable.

Network Requirements#

  • Outbound access to the Scenescape MQTT broker (default TCP 1883, or 8883 with TLS) and the Scenescape REST API (HTTPS).

  • Inbound access to TCP port 8082 (default) for API clients.

  • When the optional features are enabled, network reachability to SeaweedFS, the behavioral-analysis worker (shared MQTT broker), and the alert-service.