[Support]: in OpenVINOModelRunner: TypeError: stat: path should be string... not NoneType (Frigate 0.17)

[robertoromero2525-art]

Checklist

• I have updated to the latest available Frigate version.
• I have cleared the cache of my browser.
• I have tried a different browser to see if it is related to my browser.
• I have tried reproducing the issue in incognito mode to rule out problems with any third party extensions or plugins I have installed.
• I have asked the AI at https://docs.frigate.video about my issue.

Describe the problem you are having

In Frigate 0.17, when configuring OpenVINO as the detector and the config parser silently fails to read the model dimensions or path (or when it's not explicitly defined), the model_path variable is passed as None. This causes the container to enter a continuous crash loop.

The issue is located in frigate/detectors/detection_runners.py inside the OpenVINOModelRunner class initialization. The code assumes model_path will always be a string. Python attempts to run os.path.isfile(None) and throws a fatal exception.

2026-03-02 04:35:06.703053170 [INFO] Preparing Frigate...
2026-03-02 04:35:08.200476017 [INFO] Starting Frigate...
2026-03-02 04:35:13.251045429 [2026-03-02 00:35:13] frigate.util.config INFO : Checking if frigate config needs migration...
2026-03-02 04:35:13.267826032 [2026-03-02 00:35:13] frigate.util.config INFO : frigate config does not need migration...
2026-03-02 04:35:13.275630603 [2026-03-02 00:35:13] frigate.config.config WARNING : cam_059 detect fps is set to 20. This does NOT need to match your camera's frame rate. High values could lead to reduced performance. Recommended value is 5.
2026-03-02 04:35:13.278660560 [2026-03-02 00:35:13] frigate.app INFO : Starting Frigate (0.17.0-f0d69f7)
2026-03-02 04:35:13.296454581 [2026-03-02 00:35:13] peewee_migrate.logs INFO : Starting migrations
2026-03-02 04:35:13.296929216 [2026-03-02 00:35:13] peewee_migrate.logs INFO : There is nothing to migrate
2026-03-02 04:35:13.312308908 [2026-03-02 00:35:13] frigate.app INFO : Recording process started: 380
2026-03-02 04:35:13.327093407 [2026-03-02 00:35:13] frigate.app INFO : Review process started: 389
2026-03-02 04:35:13.328655481 [2026-03-02 00:35:13] frigate.record.maintainer WARNING : Too many unprocessed recording segments in cache for cam_059. This likely indicates an issue with the detect stream, keeping the 6 most recent segments out of 8 and discarding the rest...
2026-03-02 04:35:13.331535498 [2026-03-02 00:35:13] frigate.app INFO : go2rtc process pid: 125
2026-03-02 04:35:13.594683307 [2026-03-02 00:35:13] frigate.app INFO : Embedding process started: 406
2026-03-02 04:35:13.634005106 [2026-03-02 00:35:13] frigate.app INFO : Output process started: 457
2026-03-02 04:35:13.640698652 [2026-03-02 00:35:13] frigate.output.output ERROR : Failed to restore preview cache.
2026-03-02 04:35:13.680195615 [2026-03-02 00:35:13] frigate.camera.maintainer INFO : Camera processor started for cam_059: 515
2026-03-02 04:35:13.734321450 [2026-03-02 00:35:13] frigate.camera.maintainer INFO : Capture process started for cam_059: 574
2026-03-02 04:35:13.937161289 Process frigate.detector:ov:
2026-03-02 04:35:13.937164050 Traceback (most recent call last):
2026-03-02 04:35:13.937165297 File "/usr/lib/python3.11/multiprocessing/process.py", line 314, in _bootstrap
2026-03-02 04:35:13.937166090 self.run()
2026-03-02 04:35:13.937167061 File "/opt/frigate/frigate/object_detection/base.py", line 143, in run
2026-03-02 04:35:13.937170134 object_detector = LocalObjectDetector(detector_config=self.detector_config)
2026-03-02 04:35:13.937171769 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2026-03-02 04:35:13.937186889 File "/opt/frigate/frigate/object_detection/base.py", line 62, in init
2026-03-02 04:35:13.937188287 self.detect_api = create_detector(detector_config)
2026-03-02 04:35:13.937189165 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2026-03-02 04:35:13.937205578 File "/opt/frigate/frigate/detectors/init.py", line 18, in create_detector
2026-03-02 04:35:13.937206489 return api(detector_config)
2026-03-02 04:35:13.937207396 ^^^^^^^^^^^^^^^^^^^^
2026-03-02 04:35:13.937208482 File "/opt/frigate/frigate/detectors/plugins/openvino.py", line 45, in init
2026-03-02 04:35:13.937224283 self.runner = OpenVINOModelRunner(
2026-03-02 04:35:13.937225291 ^^^^^^^^^^^^^^^^^^^^
2026-03-02 04:35:13.937226318 File "/opt/frigate/frigate/detectors/detection_runners.py", line 299, in init
2026-03-02 04:35:13.937227275 if not os.path.isfile(model_path):
2026-03-02 04:35:13.937228080 ^^^^^^^^^^^^^^^^^^^^^^^^^^
2026-03-02 04:35:13.937228893 File "", line 30, in isfile
2026-03-02 04:35:13.937229986 TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType
2026-03-02 04:35:13.963610607 [2026-03-02 00:35:13] frigate.api.fastapi_app INFO : Starting FastAPI app
2026-03-02 04:35:14.099962815 [2026-03-02 00:35:14] frigate.api.fastapi_app INFO : FastAPI started

Steps to reproduce

1. Use a system with Intel iGPU (e.g., Alder Lake-N).

2. Configure Frigate 0.17 to use the OpenVINO detector.

3. Provide an incomplete model block or omit the path under the detector configuration.

4. Start the Frigate container.

5. The container crashes immediately with TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType..

Version

0.17.0-f0d69f7

In which browser(s) are you experiencing the issue with?

Google Chrome

Frigate config file

version: 0.17-0

mqtt:
  enabled: false

go2rtc:
  streams:
    cam_059_main:
      - rtsp://Frigate:@192.168.10.59:554/h264Preview_01_main#tcp
    cam_059_sub:
      - rtsp://Frigate:@192.168.10.59:554/h264Preview_01_sub#tcp

ffmpeg:
  hwaccel_args: preset-intel-qsv-h264

detectors:
  ov:
    type: openvino
    device: GPU

    model:
      path: /openvino-model/ssdlite_mobilenet_v2.xml
      width: 300
      height: 300
      input_tensor: nhwc
      input_pixel_format: bgr
      labelmap_path: /openvino-model/coco_91cl_bkgr.txt

objects:
  track:
    - person
    - car
    - dog
    - motorcycle
    - bicycle

record:
  enabled: true
  continuous:
    days: 0
  alerts:
    pre_capture: 2
    post_capture: 60
    retain:
      days: 10
      mode: active_objects
  detections:
    retain:
      days: 10
      mode: active_objects

snapshots:
  enabled: true

cameras:
  cam_059:
    enabled: true
    live:
      streams:
        4K: cam_059_main
        SD: cam_059_sub
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/cam_059_sub
          roles:
            - detect
        - path: rtsp://127.0.0.1:8554/cam_059_main
          roles:
            - record
    detect:
      enabled: true
      width: 1280
      height: 720
      fps: 5
    motion:
      threshold: 25
      contour_area: 5
      improve_contrast: false

docker-compose file or Docker CLI command

I am running Frigate as an official application on TrueNAS SCALE (Dragonfish). TrueNAS manages the container orchestration internally. The Intel iGPU is passed through to the container using the standard resource allocation settings in the TrueNAS UI.

My config.yml is mapped to a dataset on the host, and the detector is configured as openvino to utilize the Intel Alder Lake-N iGPU.

Relevant Frigate log output

2026-03-02 04:35:06.703053170 [INFO] Preparing Frigate...
...
TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType

Process frigate.detector:ov:
Traceback (most recent call last):
  File "/opt/frigate/frigate/detectors/plugins/openvino.py", line 45, in __init__
    self.runner = OpenVINOModelRunner(
  File "/opt/frigate/frigate/detectors/detection_runners.py", line 299, in __init__
    if not os.path.isfile(model_path):
  File "<frozen genericpath>", line 30, in isfile
TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType

Relevant go2rtc log output

2026-03-02 04:34:32.230378973  [INFO] Preparing new go2rtc config...
2026-03-02 04:34:33.087570607  [WARNING] Failed to convert HomeKit config to JSON, skipping cleanup
2026-03-02 04:34:33.087779823  [INFO] Starting go2rtc...
2026-03-02 04:34:33.485461958  00:34:33.485 INF go2rtc platform=linux/amd64 revision=df95ce3 version=1.9.10
2026-03-02 04:34:33.485465106  00:34:33.485 INF config path=/config/go2rtc_homekit.yml
2026-03-02 04:34:33.485942156  00:34:33.485 INF [rtsp] listen addr=:8554
2026-03-02 04:34:33.485944765  00:34:33.485 INF [api] listen addr=:1984
2026-03-02 04:34:33.486329974  00:34:33.486 INF [webrtc] listen addr=:8555
2026-03-02 04:34:41.104674594  [INFO] Starting go2rtc healthcheck service...

Operating system

Other Linux

Install method

Docker Compose

Network connection

Wired

Camera make and model

Reolink (Model: RLC-811A or similar 4K/8MP series using /h264Preview_01_main stream).

Screenshots of the Frigate UI's System metrics pages

I cannot provide the System Metrics screenshots because the Frigate UI is completely inaccessible. Due to the fatal TypeError during the detector initialization, the container crashes and restarts every few seconds.
+1

The Nginx logs confirm that the upstream connection is refused (111: Connection refused) because the Frigate core process is not running long enough to serve the web interface.

Any other information that may be helpful

No response

[inkeep-ai-assistant[bot]]

The issue is with your detector configuration structure. You've nested the model configuration under the detectors section, but according to the documentation, the model configuration should be at the top level of your config, not nested under detectors(1).

Your current config has:

detectors:
  ov:
    type: openvino
    device: GPU
    model:  # ← This is incorrectly nested
      path: /openvino-model/ssdlite_mobilenet_v2.xml

It should be:

detectors:
  ov:
    type: openvino
    device: GPU

model:  # ← Move this to top level
  path: /openvino-model/ssdlite_mobilenet_v2.xml
  width: 300
  height: 300
  input_tensor: nhwc
  input_pixel_format: bgr
  labelmap_path: /openvino-model/coco_91cl_bkgr.txt

The OpenVINO detector configuration only requires type and device attributes(2). The model configuration is a separate top-level section that applies globally(1).

When the model path isn't found at the expected location in the config structure, it gets passed as None to the OpenVINO model runner, which then crashes when trying to validate the file path.

📚 Sources:

1. Full Reference Config
2. Supported Hardware

---

Have another question? Just tag @inkeep.