Files
frigate/docs/docs/configuration/detectors.md
T

80 lines
1.7 KiB
Markdown
Raw Normal View History

2021-01-20 16:26:49 -08:00
---
id: detectors
title: Detectors
---
2021-09-12 14:48:21 -05:00
By default, Frigate will use a single CPU detector. If you have a Coral, you will need to configure your detector devices in the config file. When using multiple detectors, they run in dedicated processes, but pull from a common queue of requested detections across all cameras.
2021-01-20 16:26:49 -08:00
Frigate supports `edgetpu` and `cpu` as detector types. The device value should be specified according to the [Documentation for the TensorFlow Lite Python API](https://coral.ai/docs/edgetpu/multiple-edgetpu/#using-the-tensorflow-lite-python-api).
**Note**: There is no support for Nvidia GPUs to perform object detection with tensorflow. It can be used for ffmpeg decoding, but not object detection.
2021-09-12 14:48:21 -05:00
### Single USB Coral
2021-01-20 16:26:49 -08:00
```yaml
detectors:
coral:
type: edgetpu
device: usb
```
2021-09-12 14:48:21 -05:00
### Multiple USB Corals
2021-01-20 16:26:49 -08:00
```yaml
detectors:
coral1:
type: edgetpu
device: usb:0
coral2:
type: edgetpu
device: usb:1
```
2021-09-12 14:48:21 -05:00
### Native Coral (Dev Board)
_warning: may have [compatibility issues](https://github.com/blakeblackshear/frigate/issues/1706) after `v0.9.x`_
2021-06-14 19:31:09 +02:00
```yaml
detectors:
coral:
type: edgetpu
2021-09-12 14:48:21 -05:00
device: ""
2021-06-14 19:31:09 +02:00
```
2021-09-12 14:48:21 -05:00
### Multiple PCIE/M.2 Corals
2021-04-16 21:34:45 -05:00
```yaml
detectors:
coral1:
type: edgetpu
device: pci:0
coral2:
type: edgetpu
device: pci:1
```
2021-09-12 14:48:21 -05:00
### Mixing Corals
2021-01-20 16:26:49 -08:00
```yaml
detectors:
coral_usb:
type: edgetpu
device: usb
coral_pci:
type: edgetpu
device: pci
```
2021-09-12 14:48:21 -05:00
### CPU Detectors (not recommended)
2021-01-20 16:26:49 -08:00
```yaml
detectors:
cpu1:
type: cpu
2021-09-12 14:48:21 -05:00
num_threads: 3
2021-01-20 16:26:49 -08:00
cpu2:
type: cpu
2021-09-12 14:48:21 -05:00
num_threads: 3
2021-01-20 16:26:49 -08:00
```
2021-09-12 14:48:21 -05:00
When using CPU detectors, you can add a CPU detector per camera. Adding more detectors than the number of cameras should not improve performance.