apiai 0.0.3

The API.AI iOS SDK makes it easy to integrate speech recognition with API.AI natural language processing API on iOS devices.

api.ai: Python SDK for `API.AI <http://api.ai>`_
=========================

.. image:: https://badge.fury.io/py/apiai.svg
:target: http://badge.fury.io/py/apiai

.. image:: https://travis-ci.org/api-ai/api-ai-python.svg
:target: https://travis-ci.org/api-ai/api-ai-python


Overview
--------

The API.AI Python SDK makes it easy to integrate speech recognition with API.AI natural language processing API. API.AI allows using voice commands and integration with dialog scenarios defined for a particular agent in API.AI.

Prerequsites
--------

Create an `API.AI account <http://api.ai>`_.


Running examples
--------

1. Find examples from 'examples' path.
2. Insert API key & subscription.

.. code-block:: python

>>> CLIENT_ACCESS_TOKEN = '<YOUR_CLIENT_ACCESS_TOKEN>'
>>> SUBSCRIBTION_KEY = '<YOUR_SUBSCRIBTION_KEY>'
...

Features
--------

- Speech Recognition.
- Voice Activity Detection.
- Natural Language Processing.

Installation
------------

To install apiai, simply:

.. code-block:: bash

$ pip install apiai

or install it from repo:

.. code-block:: bash

$ pip install https://github.com/api-ai/api-ai-python.git

You might run into problems because some dependencies in your python environment are missing. You need to install numpy (which is available in alomost all package managers) and `scipy <http://www.scipy.org/install.html>`_. For running the examples you also need python audio.

In ubunutu the following will do the job:

.. code-block:: bash

$ apt-get install python-pyaudio python-numpy python-scipy python-matplotlib ipython ipython-notebook python-pandas python-sympy python-nose python-pip
$ pip install apiai

Documentation
-------------

Documentation is available at http://api.ai.



.. :changelog:

Release History
---------------

0.0.1 (1014-03-1)
++++++++++++++++++

* Conception