python-ivona-api

Python library that helps you connect to Amazon’s IVONA Speech Cloud from within your Python project. All you need to use it are the access keys.

It currently only implements CreateSpeech and ListVoices endpoints, as they should cover the vast majority of use cases. Lexicons endpoints may be added in the future.

If you’re looking for out-of-the-box solution, you should probably use ivona-speak - it’s a script that uses this library and lets you use its functionality directly from your shell.

Installation

From PyPI:

$ pip install ivona_api

API

There’s no proper documentation as of now, but the code is commented and should be pretty straightforward to use.

That said - feel free to open a GitHub issues if anything is unclear.

Tests

Package was tested with the help of py.test and tox on Python 2.7, 3.4, 3.5 and 3.6 (see tox.ini).

Code coverage is available at Coveralls.

To run tests yourself you need to set environment variables with secret and access keys before running tox inside the repository:

$ export IVONA_ACCESS_KEY='...'
$ export IVONA_SECRET_KEY='...'
$ pip install tox
$ tox

Contributions

Package source code is available at GitHub.

Feel free to use, ask, fork, star, report bugs, fix them, suggest enhancements, add functionality and point out any mistakes. Thanks!

Authors

Developed and maintained by Pythonity, a group of Python enthusiasts who love open source, have a neat blog and are available for hire.

Written by Paweł Adamczak.

Released under MIT License.