actionseval/cintent-208

drivendataorg/zamba at 670a486fed07e1c93efc911f5eecd2eb7f080c99 for .github/workflows/tests.yml # zamba - a command line interface for species classification ### HOMEPAGE ### DOCUMENTATION _Zamba means "forest" in the Lingala language._ Zamba is a command-line tool built in Python to automatically identify the species seen in camera trap videos from sites in central Africa. The tool makes predictions for 24 common species in these videos. For more information, see the documentation. The `zamba` command will be the entry point for users (see example usage below). ## Prerequisites (for more detail, see the documentation) - Python 3.6 - ffmpeg, codecs for handling the video loading ## Installing `zamba` (for more detail, see the documentation) ### GPU or CPU `zamba` is significantly faster when using a machine with a GPU instead of just a CPU. To use a GPU, you must be using an nvidia gpu, installed and configured CUDA, and installed and configured CuDNN per their specifications. Once this is done, you can select to install the version of zamaba that uses `tensorflow` compiled for GPU. When a user installs `zamba` that user must specify to install the GPU or CPU version. If the user fails to make this specification, **no version of tensorflow will be installed, thus everything will fail.** To install with **tensorflow cpu** (you do not have a GPU) ``` $ pip install zamba[cpu] ``` To install with **tensorflow gpu** ``` $ pip install zamba[gpu] ``` ## Example usage Once zamba is installed, you can see the commands with `zamba`: `zamba` ``` Usage: zamba [OPTIONS] COMMAND [ARGS]... Options: --help Show this message and exit. Commands: predict Identify species in a video. train [NOT IMPLEMENTED] Retrain network from... tune [NOT IMPLEMENTED] Update network with new... ``` And you can see the options you can pass to the `predict` command with: `zamba predict --help` ``` Usage: zamba predict [OPTIONS] [DATA_PATH] [PRED_PATH] Identify species in a video. This is a command line interface for prediction on camera trap footage. Given a …