Metadata-Version: 2.0
Name: apiai
Version: 0.0.6
Summary: The API.AI iOS SDK makes it easy to integrate speech recognition with API.AI natural language processing API on iOS devices.
Home-page: https://api.ai/
Author: Dmitriy Kuragin
Author-email: kuragin@speaktoit.com
License: Apache 2.0
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: numpy
Requires-Dist: scipy

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>'
    >>> SUBSCRIPTION_KEY = '<YOUR_SUBSCRIPTION_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

