[Support]: OpenVINO Detector: TypeError on model.path in Frigate 0.15.x/0.16.x Beta

[pentecosthub]

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.

Describe the problem you are having

When configuring Frigate to use an OpenVINO detector on an Intel iGPU, the detector consistently fails to initialize with a TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType. This occurs specifically at the point where os.path.isfile() attempts to validate the detector_config.model.path.

Despite the config.yml explicitly defining the model path as a string (path: /openvino-model/ssdlite_mobilenet_v2.xml) and verification that the model files (.xml and .bin) are correctly present and accessible inside the Docker container at that exact path, the Frigate backend seems to be receiving None for this value internally.

When the detectors section is entirely removed from the config.yml, Frigate starts successfully and defaults to CPU-based detection, confirming the issue is isolated to the OpenVINO detector's initialization. This bug persists across both Frigate 0.15.x stable and 0.16.0-beta3 images.

Steps to reproduce

Steps to reproduce:

1. Prepare config.yml:
   Ensure your Frigate configuration file (config.yml on the host, e.g., /home/carl/frigate/config.yml) includes the detectors section for OpenVINO as shown in the "Relevant Configuration" section of this report.

2. Place OpenVINO Models:
   Ensure the necessary OpenVINO model files (ssdlite_mobilenet_v2.xml and ssdlite_mobilenet_v2.bin) are present on your host machine in the directory that will be mounted to /openvino-model/ inside the container (e.g., /home/carl/frigate/openvino-model/).

3. Start the Frigate Docker Container:
   Use a docker run command similar to the one below. This assumes your storage and config paths are set up correctly on the host. Replace <your_password_for_rtsp> with your actual camera password if you haven't already.

   docker run -d \
     --name frigate \
     --privileged \
     --restart=unless-stopped \
     --mount type=tmpfs,target=/tmp/cache,tmpfs-size=1024m \
     -v /etc/localtime:/etc/localtime:ro \
     -v /home/carl/frigate/config.yml:/config/config.yml:ro \
     -v /home/carl/frigate/storage:/media/frigate \
     -v /dev/dri:/dev/dri \
     -v /dev/bus/usb:/dev/bus/usb \
     -p 5000:5000 \
     -p 8554:8554 \
     -p 8555:8555 \
     ghcr.io/blakeblackshear/frigate:0.16.0-beta3 # Or blakeblackshear/frigate:stable

4. Monitor Frigate Logs:
   Observe the container logs immediately after starting:

   docker logs -f frigate

5. Observe Error:
   The TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType traceback will appear during the detector initialization phase.

Version

Version: * Frigate: 0.16.0-beta3 (currently testing), also observed on 0.15.0-6cb5cfb (which was the stable tag at the time of initial testing). * Operating System: Ubuntu-based Linux (running Docker) * Detector: OpenVINO * OpenVINO Version (as bundled with Frigate image): The 0.16.0-beta3 release notes indicate that OpenVINO was updated to 2024.3.

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

cli

Frigate config file

# config.yml
mqtt:
  enabled: false

detectors:
  openvino:
    type: openvino
    device: "GPU"
    model:
      path: /openvino-model/ssdlite_mobilenet_v2.xml

cameras:
  tapo_c120:
    enabled: true
    ffmpeg:
      inputs:
        - path: "rtsp://[YOUR_USERNAME]:[YOUR_PASSWORD]@192.168.99.80:554/stream1"
          roles:
            - detect
            - record
    detect:
      enabled: true
      width: 1920
      height: 1080
    record:
      enabled: true
      retain:
        days: 3
        mode: motion

snapshots:
  enabled: true
  retain:
    default: 3

birdseye:
  enabled: true
  mode: motion

ffmpeg:
  hwaccel_args:
    - -hwaccel
    - vaapi
    - -hwaccel_device
    - /dev/dri/renderD128
    - -hwaccel_output_format
    - yuv420p

timestamp_style:
  position: "tl"
  format: "%Y-%m-%d %H:%M:%S"

docker-compose file or Docker CLI command

docker run -d \
  --name frigate \
  --privileged \
  --restart=unless-stopped \
  --mount type=tmpfs,target=/tmp/cache,tmpfs-size=1024m \
  -v /etc/localtime:/etc/localtime:ro \
  -v /home/carl/frigate/config.yml:/config/config.yml:ro \
  -v /home/carl/frigate/storage:/media/frigate \
  -v /dev/dri:/dev/dri \
  -v /dev/bus/usb:/dev/bus/usb \
  -p 5000:5000 \
  -p 8554:8554 \
  -p 8555:8555 \
  ghcr.io/blakeblackshear/frigate:0.16.0-beta3

Relevant Frigate log output

2025-06-16 17:53:42.143353008  [2025-06-16 17:53:42] frigate.app                 INFO    : Starting Frigate (0.16.0-f141b58)
2025-06-16 17:53:42.150162310  [2025-06-16 17:53:42] peewee_migrate.logs           INFO    : Starting migrations
2025-06-16 17:53:42.151164618  [2025-06-16 17:53:42] peewee_migrate.logs           INFO    : There is nothing to migrate
2025-06-16 17:53:42.158254211  [2025-06-16 17:53:42] frigate.app                 INFO    : Recording process started: 380
2025-06-16 17:53:42.164871254  [2025-06-16 17:53:42] frigate.app                 INFO    : Review process started: 385
2025-06-16 17:53:42.168236589  [2025-06-16 17:53:42] frigate.app                 INFO    : go2rtc process pid: 121
2025-06-16 17:53:42.181623889  [2025-06-16 17:53:42] detector.openvino             INFO    : Starting detection process: 405
2025-06-16 17:53:42.185267040  Process detector:openvino:
2025-06-16 17:53:42.185271029  Traceback (most recent call last):
2025-06-16 17:53:42.185273525    File "/usr/lib/python3.11/multiprocessing/process.py", line 314, in _bootstrap
2025-06-16 17:53:42.185277900      self.run()
2025-06-16 17:53:42.185281067    File "/opt/frigate/frigate/util/process.py", line 41, in run_wrapper
2025-06-16 17:53:42.185283084      return run(*args, **kwargs)
2025-06-16 17:53:42.185302490              ^^^^^^^^^^^^^^^^^^^^
2025-06-16 17:53:42.185304759    File "/usr/lib/python3.11/multiprocessing/process.py", line 108, in run
2025-06-16 17:53:42.185307373      self._target(*self._args, **self._kwargs)
2025-06-16 17:53:42.185309720    File "/opt/frigate/frigate/object_detection/base.py", line 112, in run_detector
2025-06-16 17:53:42.185312069      object_detector = LocalObjectDetector(detector_config=detector_config)
2025-06-16 17:53:42.185314314                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-06-16 17:53:42.185339388    File "/opt/frigate/frigate/object_detection/base.py", line 57, in __init__
2025-06-16 17:53:42.185341566      self.detect_api = create_detector(detector_config)
2025-06-16 17:53:42.185360336                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-06-16 17:53:42.185363160    File "/opt/frigate/frigate/detectors/__init__.py", line 18, in create_detector
2025-06-16 17:53:42.185365253      return api(detector_config)
2025-06-16 17:53:42.185367161              ^^^^^^^^^^^^^^^^^^^^
2025-06-16 17:53:42.185369729    File "/opt/frigate/frigate/detectors/plugins/openvino.py", line 46, in __init__
2025-06-16 17:53:42.185372008      if not os.path.isfile(detector_config.model.path):
2025-06-16 17:53:42.185374177                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2025-06-16 17:53:42.185376248    File "<frozen genericpath>", line 30, in isfile
2025-06-16 17:53:42.185394401  TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType
2025-06-16 17:53:42.190164449  [2025-06-16 17:53:42] frigate.app                 INFO    : Output process started: 422
2025-06-16 17:53:42.205699428  [2025-06-16 17:53:42] frigate.app                 INFO    : Camera processor started for tapo_c120: 443
2025-06-16 17:53:42.206176589  [2025-06-16 17:53:42] frigate.app                 WARNING : The current SHM size of 64.0MB is too small, recommend increasing it to at least 114MB.
2025-06-16 17:53:42.215885284  [2025-06-16 17:53:42] frigate.app                 INFO    : Capture process started for tapo_c120: 454

Relevant go2rtc log output

2025-06-16 17:53:40.022504941  [INFO] Starting go2rtc...
2025-06-16 17:53:40.103240766  17:53:40.103 INF go2rtc platform=linux/amd64 revision=fa580c5 version=1.9.9
2025-06-16 17:53:40.103245642  17:53:40.103 INF config path=/dev/shm/go2rtc.yaml
2025-06-16 17:53:40.103610386  17:53:40.103 INF [rtsp] listen addr=:8554
2025-06-16 17:53:40.103717305  17:53:40.103 INF [api] listen addr=:1984
2025-06-16 17:53:40.104021517  17:53:40.103 INF [webrtc] listen addr=:8555

Operating system

Debian

Install method

Docker CLI

Network connection

Wired

Camera make and model

tapo 120 and 101

Screenshots of the Frigate UI's System metrics pages

N/A

Any other information that may be helpful

Internal Container Verification: I have thoroughly verified that my config.yml file and the OpenVINO model files (ssdlite_mobilenet_v2.xml and ssdlite_mobilenet_v2.bin) are correctly mounted and accessible inside the Frigate Docker container at their specified paths (/config/config.yml and /openvino-model/ respectively). I ran manual cat and ls -l commands within the running container and confirmed their presence and correct content. This strongly suggests the issue isn't related to Docker volume mounting or file permissions at the OS level.

Problem Isolation: A critical finding from my troubleshooting is that Frigate starts successfully and performs detection (using the default CPU detector) when I completely remove the detectors section from my config.yml. This definitively isolates the TypeError to Frigate's OpenVINO integration code path itself.

Hardware Environment: My host system is a Dell Mini Form Factor PC, and I'm using its integrated Intel iGPU for hardware acceleration and the intended OpenVINO detection. The hwaccel_args in my config specify /dev/dri/renderD128.

go2rtc Functionality: go2rtc consistently starts and logs normally, indicating it isn't causing or contributing to the detector failure.

Previous State: Before this specific TypeError started, Frigate was working, but I noticed it was performing poorly. While the current error is a complete stop for the detector, this might suggest an underlying, perhaps less critical, issue existed prior.

[hawkeye217]

This is not a bug.

model does not belong under detectors.

See the documentation: https://docs.frigate.video/configuration/object_detectors/#openvino-detector

[pentecosthub]

Thanks for the quick response!

I've updated my config.yml as suggested, placing the path directly under the openvino detector, like this:

detectors:
  openvino:
    type: openvino
    device: "GPU"
    path: /openvino-model/ssdlite_mobilenet_v2.xml # Changed as per feedback 

However, after recreating the container with this updated configuration, I'm still encountering the exact same TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType from openvino.py line 46 (if not os.path.isfile(detector_config.model.path):).
It appears that detector_config.model.path is still evaluating to NoneType internally, despite the change.
Here are the latest relevant logs:

2025-06-16 19:11:34.106556574  You have successfully opted out to send the telemetry data.
2025-06-16 19:11:34.125036489  [INFO] Preparing Frigate...
2025-06-16 19:11:34.592440832  [INFO] Preparing new go2rtc config...
2025-06-16 19:11:34.629349523  [INFO] Starting Frigate...
2025-06-16 19:11:34.801100512  2025/06/16 19:11:34 [error] 187#187: *1 connect() failed (111: Connection refused) while connecting to upstream, client: 192.168.15.21, server: , request: "GET /api/stats HTTP/1.1", subrequest: "/auth", upstream: "http://127.0.0.1:5001/auth", host: "192.168.15.22:5000"
2025-06-16 19:11:34.801249207  2025/06/16 19:11:34 [error] 187#187: *1 auth request unexpected status: 502 while sending to client, client: 192.168.15.21, server: , request: "GET /api/stats HTTP/1.1", host: "192.168.15.22:5000"
2025-06-16 19:11:35.024157154  [INFO] Starting go2rtc...
2025-06-16 19:11:35.107366511  19:11:35.107 INF go2rtc platform=linux/amd64 revision=fa580c5 version=1.9.9
2025-06-16 19:11:35.107386136  19:11:35.107 INF config path=/dev/shm/go2rtc.yaml
2025-06-16 19:11:35.107779117  19:11:35.107 INF [rtsp] listen addr=:8554
2025-06-16 19:11:35.107839748  19:11:35.107 INF [api] listen addr=:1984
2025-06-16 19:11:35.108252532  19:11:35.108 INF [webrtc] listen addr=:8555
s6-rc: info: service nginx successfully started
s6-rc: info: service certsync: starting
2025-06-16 19:11:35.592160293  [INFO] Starting certsync...
s6-rc: info: service certsync successfully started
s6-rc: info: service legacy-services: starting
s6-rc: info: service legacy-services successfully started
2025-06-16 19:11:36.112474894  127.0.0.1 - - [16/Jun/2025:19:11:36 -0400] "" 400 0 "-" "-" "-"
2025-06-16 19:11:37.054280801  [2025-06-16 19:11:37] frigate.util.config           INFO    : Checking if frigate config needs migration...
2025-06-16 19:11:37.054647355  [2025-06-16 19:11:37] frigate.util.config           ERROR   : Config file is read-only, unable to migrate config file.
2025-06-16 19:11:37.058281124  [2025-06-16 19:11:37] frigate.app                   INFO    : Starting Frigate (0.16.0-f141b58)
2025-06-16 19:11:37.066445985  [2025-06-16 19:11:37] peewee_migrate.logs           INFO    : Starting migrations
2025-06-16 19:11:37.067523915  [2025-06-16 19:11:37] peewee_migrate.logs           INFO    : There is nothing to migrate
2025-06-16 19:11:37.074526737  [2025-06-16 19:11:37] frigate.app                   INFO    : Recording process started: 381
2025-06-16 19:11:37.081189542  [2025-06-16 19:11:37] frigate.app                   INFO    : Review process started: 386
2025-06-16 19:11:37.085592968  [2025-06-16 19:11:37] frigate.app                   INFO    : go2rtc process pid: 113
2025-06-16 19:11:37.098587758  [2025-06-16 19:11:37] detector.openvino             INFO    : Starting detection process: 406
2025-06-16 19:11:37.103964184  Process detector:openvino:
2025-06-16 19:11:37.103967968  Traceback (most recent call last):
    File "/usr/lib/python3.11/multiprocessing/process.py", line 314, in _bootstrap
      self.run()
    File "/opt/frigate/frigate/util/process.py", line 41, in run_wrapper
      return run(*args, **kwargs)
              ^^^^^^^^^^^^^^^^^^^^
    File "/usr/lib/python3.11/multiprocessing/process.py", line 108, in run
      self._target(*self._args, **self._kwargs)
    File "/opt/frigate/frigate/object_detection/base.py", line 112, in run_detector
      object_detector = LocalObjectDetector(detector_config=detector_config)
                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/opt/frigate/frigate/object_detection/base.py", line 57, in __init__
      self.detect_api = create_detector(detector_config)
                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "/opt/frigate/frigate/detectors/__init__.py", line 18, in create_detector
      return api(detector_config)
              ^^^^^^^^^^^^^^^^^^^^
    File "/opt/frigate/frigate/detectors/plugins/openvino.py", line 46, in __init__
      if not os.path.isfile(detector_config.model.path):
                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    File "<frozen genericpath>", line 30, in isfile
  TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType
2025-06-16 19:11:37.111535645  [2025-06-16 19:11:37] frigate.app                   INFO    : Output process started: 423
2025-06-16 19:11:37.130042056  [2025-06-16 19:11:37] frigate.app                   INFO    : Camera processor started for tapo_c120: 444
2025-06-16 19:11:37.131102004  [2025-06-16 19:11:37] frigate.app                   WARNING : The current SHM size of 64.0MB is too small, recommend increasing it to at least 114MB.
2025-06-16 19:11:37.142551727  [2025-06-16 19:11:37] frigate.app                   INFO    : Capture process started for tapo_c120: 448
2025-06-16 19:11:37.177891457  [2025-06-16 19:11:37] frigate.video                 ERROR   : tapo_c120: Unable to read frames from ffmpeg process.
2025-06-16 19:11:37.178488986  [2025-06-16 19:11:37] frigate.video                 ERROR   : tapo_c120: ffmpeg process is not running. exiting capture thread...
2025-06-16 19:11:37.436362076  [2025-06-16 19:11:37] frigate.api.fastapi_app       INFO    : Starting FastAPI app
2025-06-16 19:11:37.656030828  [2025-06-16 19:11:37] frigate.api.fastapi_app       INFO    : FastAPI started

Could you please provide further guidance on how to correctly specify the OpenVINO model path to avoid this NoneType error? It's confusing because the traceback explicitly points to detector_config.model.path, and the official documentation (https://docs.frigate.video/configuration/object_detectors/#openvino-detector) also shows a nested model: block with path: for OpenVINO (similar to how I originally had it).

[NickM-27]

this is still not correct / does not match what is in the docs

[hawkeye217]

From the docs:

detectors:
  ov:
    type: openvino
    device: GPU

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

[pentecosthub]

Can't thank you enough for your patient replies. I still can't get this thing working. Where would you recommend I paste my entire config for someone to tell me where I'm getting it wrong? Clearly I am way in over my head.

[pentecosthub]

I don't know what to say. It works now. I went down this road because my CPU was sitting at 90%. Now it's somewhere around 30. Thank you so much.

[hawkeye217]

Great! Glad it's working for you. Happy to help.

[ljz51]

i use the gemini created config file, it produced the same error, move the model to the right place solve the problem,thks!