Metadata-Version: 2.0
Name: behavioral-signals-cli
Version: 1.2.0
Summary: Command Line Interface for Behavioral Signals Emotion and     Behavior Recognition Engine in the Cloud
Home-page: https://bitbucket.org/behavioralsignals/api-cli/src
Author: Behavioral Signals
Author-email: nassos@behavioralsignals.com
License: MIT license
Download-URL: https://bitbucket.org/behavioralsignals/api-cli/get/1.2.0.tar.gz
Description-Content-Type: UNKNOWN
Keywords: behavioral_signals_cli
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: behavioral-signals-swagger-client (>=2.0.0)
Requires-Dist: dotmap
Requires-Dist: python-dateutil
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: ruamel.yaml

# Behavioral Signals CLI

Command Line Interface for Behavioral Signals' Emotion and Behavior Recognition in the Cloud


* Free software: MIT license

## Install
```
pip install behavioral_signals_cli
```

## Getting Started

* First request your account id and token for the Behavioral Signals Web API by sending an email to nassos@behavioralsignals.com
* Export the following as environmental variables (see below for ore elaborate configuration):
```
   export BEST_API_ID=your_id_on_service_api
   export BEST_API_TOKEN=your_token_for_service_api
```

* Run the CLI to submit your audio files (use bsi-cli for less typing):
```
   behaviorals_signals_cli send_audio [csv_file] [pids_log]
```
   The .csv file must have the following form (order matters):
path/to/file, number of channels, call direction, agentId, agentTeam, campaign Id, calltype, calltime, timezone, ANI. The [pids_log] file
is an empty file where the process ids of the created jobs will be written.

* Run the CLI to get the emotion/behavior recognition, diarization and other results:
```
   behaviorals_signals_cli get_results [pids_log] [results_dir]
```
   The results will be written as .json files inside [results_dir] (polling may be performed if results
   are not readily available).

* Run the CLI to get ASR results:
```
   behaviorals_signals_cli get_results_asr [pids_log] [results_dir]
```
   The results will be written as "[filename]_[pid]_words.json" files inside [results_dir] (polling may be performed if results
   are not readily available).

you may use bsi-cli instead of behaviorals_signals_cli 
for less typing :-)

Type:
```
   behavioral_signals_cli --help 
```
for more info.


Features
--------
The CLI allows you to easily:

- Submit multiple audio files to API,
- Get behavior and emotion recognition results
- Get speech recognition results

* TODO

Configuration
--------
The CLI allows you to use a flexible configuration, since it accepts
with increasing priority:

-  internal defaults (specified in the source code of the cli)
-  environment variables (for the security tokens)
-  external configuration file with sections (see demo for examples). If not specified, it will look for ./bsi-cli.conf and ~/.bsi-cli.conf)
-  command line opions (see bsi-cli -h)

the subcommand: "bsi-cli config" displays the current configuration values.
For example:
```
*** bsi-cli configuration
           apiid : yyyy
        apitoken : xxxxx
          apiurl : http://api.bsis.me:8080
  configLocation : bsi-cli.conf
      configfile : None
             log : WARNING
            stag : default
***
```

Main configuration variables
---------------------

- BSI_API_ID (apiid, or --apiid)      : application id -- provided by BSI
- BSI_API_TOKEN (apitoken, --apitoken) : application token -- provided by BSI
- apiurl, --apiurl: usually http://api.bsis.me:8080: the address of the caller service

BSI_* are environment variables
api* are configuration file parameters
--api* are command line parameters


Credits
---------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage



=======
History
=======

0.1.0 (2017-11-17)
------------------

* First release on PyPI.


