findface-facerouter

Important

The findface-facerouter is not included in the FindFace Security standard configuration. Use it for integration if necessary. See Custom Plugins.

The findface-facerouter service sets processing directives for faces detected in video. The directives are set through custom plugins.

The findface-facerouter service accepts a face bbox and normalized image along with the original image and other data (for example, the detection date and time) from the findface-video-worker service. In general, findface-facerouter allows you to apply arbitrary face processing directives, including directly sending faces to a partner application. In the basic configuration, findface-facerouter is pre-configured to redirect faces to findface-sf-api for further processing, but you will still have to set processing directives by creating a plugin.

Functionality:

  • sets processing directives for faces detected in video,
  • redirects faces detected in video to findface-sf-api or other service (including a third-party application) for further processing.

The findface-facerouter configuration is done through a configuration file /etc/findface-facerouter.py.

# main.py options:
# debug                          = False
## debug - debug mode
# detector                       = ''
## detector - Detector to use if client fails to provide normalized face
## (nnd).Use "nnd" if you need to detect faces in such requests. Empty value
## rejects requests without normalized.
# host                           = ''
## host - host to listen
# port                           = 18820
## port - port to listen
# prometheus_timing_buckets      = None
## prometheus_timing_buckets - prometheus histogram buckets (python list of
## numbers, e.g. [1,2,3])
# sfapi_url                      = 'http://localhost:18411'
## sfapi_url - SF-API URL
# version                        = False
## version - print version
# plugin_dir.py options:
# plugin_dir                     = ''
## plugin_dir - Plugin directory for plugin_source='dir'
# abstract_define.py options:
# plugin_source                  = 'dir'
## plugin_source - Plugin source (dir)
# log.py options:
# log_file_max_size              = 100000000
## log_file_max_size - max size of log files before rollover
# log_file_num_backups           = 10
## log_file_num_backups - number of log files to keep
# log_file_prefix                = None
## log_file_prefix - Path prefix for log files. Note that if you are running
## multiple tornado processes, log_file_prefix must be different for each of
## them (e.g. include the port number)
# log_rotate_interval            = 1
## log_rotate_interval - The interval value of timed rotating
# log_rotate_mode                = 'size'
## log_rotate_mode - The mode of rotating files(time or size)
# log_rotate_when                = 'midnight'
## log_rotate_when - specify the type of TimedRotatingFileHandler interval other
## options:('S', 'M', 'H', 'D', 'W0'-'W6')
# log_to_stderr                  = None
## log_to_stderr - Send log output to stderr (colorized if possible). By default
## use stderr if --log_file_prefix is not set and no other logging is
## configured.
# logging                        = 'info'
## logging - Set the Python log level. If 'none', tornado won't touch the
## logging configuration.

When configuring findface-facerouter, refer to the following parameters:

Parameter Description
sfapi_url IP address and port of the findface-sf-api host.
plugin_dir Directory with plugins to define face processing directives.