_____ ____ _____    ____         _
                |  _  |  __|  _  |  |  __|___ ___|_|___ ___
                |     |__  |    -   |  __|   | _ | |   | -_|
                |__|__|____|__|__|  |____|_|_|__ |_|_|_|___|
                ©2019-2024 Mod9 Technologies  |__|  v. 1.9.5

Default usage:    engine
Loads default ASR model for English (along with G2P and NLP models).

Example usage:    engine --models.asr=en,es,mod9/en-US_phone-ivector
Loads various operator-specified ASR models when starting the Engine.

Advanced usage:   engine --models.asr= --models.mutable
Start with no ASR models; clients may load, unload, and modify models in memory.

ASR models load from directories in the asr/ subdirectory of --models.path.
The first loaded ASR model is a default for requests with no "asr-model" option.

G2P and NLP models also load from subdirectories of --models.path.
These may be configured to match an ASR model's language and its phones.

NOTE: set option values with an equals sign: e.g. --port=9900 (not --port 9900).

Options (full):
  --accept-license            : Set as "yes" to accept license agreement; see --license option. (string, default = "")
  --determinize.max-mem       : Retry determinization if this approximate limit is exceeded. (int, default = 100000000)
  --determinize.max-tries     : Maximum number of times to (re)try (more pruned) determinization. (int, default = 2)
  --help-full                 : Print this usage message, with advanced options.
  --initial-requests-file     : JSONL file with initial requests to be sent after model loading. (string, default = "")
  --license                   : Show the applicable license agreement.
  --limit.memory-gib          : Refuse processing if overall server memory usage will exceed this limit.
                                The units are specified as gibibytes; negative means unlimited. (float, default = -1)
  --limit.memory-headroom-gib : Refuse processing if this much memory will not be available. (float, default = 0)
  --limit.read-line-kib       : Maximum memory used to read a request's options as single-line JSON.
                                The units are specified as kibibytes. (float, default = 1024)
  --limit.read-line-timeout   : Maximum seconds to wait for a request's options line to be read. (float, default = 60)
  --limit.read-stream-kib     : Maximum memory for buffering audio stream before ASR processing. (float, default = 16)
  --limit.read-stream-timeout : Maximum seconds to wait for new data to be read from the audio stream.
                                This timeout resets after each read of up to 128 bytes. (float, default = 10)
  --limit.read-wav-header-kib : Maximum memory, in KiB, used to read a WAV-formatted header. (float, default = 1024)
  --limit.requests            : Concurrent requests that require non-trivial processing. (int, default = -1)
  --limit.requests.add-words  : [DEPRECATED] Same as --limit-requests.mutable as of current version. (int, default = -1)
  --limit.requests.mutable    : Limit the number of model-modifying requests the Engine will accept. (int, default = -1)
  --limit.threads             : Concurrent processing threads, across all requests. (int, default = -1)
  --limit.threads-per-request : Concurrent processing threads, for any single request. (int, default = 32)
  --limit.throttle-factor     : Start throttling if allocated threads exceed factor x CPUs. (float, default = 2)
  --limit.throttle-threads    : Number of batch threads per request, when throttled. (int, default = 4)
  --log.directory             : Directory for storing log files; disable file logging with "". (string, default = "")
  --log.level-console         : Minimum severity level for logs printed to the console.
                                Levels: debug, info, warning, error, fatal. (string, default = "info")
  --log.level-file            : Minimum severity level for logs written to a file.
                                Levels: debug, info, warning, error, fatal. (string, default = "info")
  --log.max-dir-size          : Remove oldest files when the log directory reaches this size. (int, default = 104857600)
  --log.max-file-size         : Rotate logs with timestamped file names, when they exceed this size.
                                Log files might also be rotated when the server exits. (int, default = 10485760)
  --mkl.data-type             : Data type for Intel MKL (e.g. bf16, f16, f32, int8, int16) (string, default = "f32")
  --mkl.max-cache-gib         : Memory used to cache compute-optimized acoustic models. (float, default = 1)
  --mkl.reproducibility       : Enable deterministic results on all Intel compatible CPUs. (bool, default = false)
  --models.asr                : Comma-separated names of ASR models to load.
                                 (string, default = "en")
  --models.g2p                : Comma-separated names of G2P models to load. (string, default = "mod9/en")
  --models.indexed            : Create an index to speed up some bias-words requests. (bool, default = false)
  --models.mutable            : Enable commands that customize ASR models.
                                 (bool, default = false)
  --models.nlp                : Comma-separated names of NLP models to load. (string, default = "en")
  --models.path               : Root directory with model subdirectories.
                                 (string, default = "/opt/mod9-asr/models")
  --port                      : Listen on this TCP port. (int, default = 9900)
  --shutdown.allowed          : Allow clients to request shutdown command. (bool, default = false)
  --shutdown.sigterm-code     : Exit code if the server exits because of SIGTERM. (int, default = 0)
  --shutdown.timeout-code     : Exit code if the server times out during shutdown request. (int, default = 1)
  --version                   : Show the version number and build metadata.