https://github.com/pythonity/python-ivona-api

Python library that helps you connect to Amazon's IVONA Speech Cloud from within your Python project.
https://github.com/pythonity/python-ivona-api

api-wrapper ivona python

Last synced: 9 months ago
JSON representation

Python library that helps you connect to Amazon's IVONA Speech Cloud from within your Python project.

• Host: GitHub
• URL: https://github.com/pythonity/python-ivona-api
• Owner: Pythonity
• License: mit
• Created: 2016-06-06T22:33:22.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-06-15T21:06:37.000Z (over 8 years ago)
• Last Synced: 2025-04-09T22:18:11.813Z (9 months ago)
• Topics: api-wrapper, ivona, python
• Language: Python
• Homepage: http://pythonity.github.io/python-ivona-api/
• Size: 43.9 KB
• Stars: 7
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# python-ivona-api

[![Build status](https://img.shields.io/travis/Pythonity/python-ivona-api.svg)][travis]

[![Test coverage](https://img.shields.io/coveralls/Pythonity/python-ivona-api.svg)][coveralls]

[![PyPI version](https://img.shields.io/pypi/v/ivona_api.svg)][pypi]

[![Python versions](https://img.shields.io/pypi/pyversions/ivona_api.svg)][pypi]

[![License](https://img.shields.io/github/license/Pythonity/python-ivona-api.svg)][license]

Python library that helps you connect to Amazon's [IVONA][ivona] Speech Cloud

from within your Python project. All you need to use it are the

[access keys][ivona 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][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][github add issue] 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][coveralls].

To run tests yourself you need to set environment variables with secret

and access keys before running `tox` inside the repository:

```shell

$ export IVONA_ACCESS_KEY='...'

$ export IVONA_SECRET_KEY='...'

$ pip install tox

$ tox

```

## Contributions

Package source code is available at [GitHub][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][pythonity], a group of Python

enthusiasts who love open source, have a neat [blog][pythonity blog] and are

available [for hire][pythonity].

Written by [Paweł Adamczak][pawelad].

Released under [MIT License][license].

[coveralls]: https://coveralls.io/github/Pythonity/python-ivona-api

[github]: https://github.com/Pythonity/python-ivona-api

[github add issue]: https://github.com/Pythonity/python-ivona-api/issues/new

[ivona keys]: http://developer.ivona.com/en/speechcloud/introduction.html#Credentials

[ivona speak]: https://github.com/Pythonity/ivona-speak

[ivona]: https://www.ivona.com/

[license]: https://github.com/Pythonity/python-ivona-api/blob/master/LICENSE

[pawelad]: https://github.com/pawelad

[pypi]: https://pypi.python.org/pypi/ivona_api

[pythonity]: https://pythonity.com/

[pythonity blog]: http://blog.pythonity.com/

[travis]: https://travis-ci.org/Pythonity/python-ivona-api