<p align="center">
<img src="https://raw.githubusercontent.com/ImNimboss/uberduck/main/.github/assets/uberduck-logo.png" alt="Uberduck Logo">
</p>
# Uberduck
<a href="https://pypi.org/project/uberduck" target="_blank" rel="noopener noreferrer">
<img src="https://img.shields.io/pypi/v/uberduck.svg?color=9cf&logo=pypi" alt="PyPI Uberduck version number">
<img src="https://img.shields.io/pypi/dm/uberduck?color=9cf&logo=pypi" alt="PyPI downloads per month">
<img src="https://img.shields.io/pypi/pyversions/uberduck.svg?color=9cf&logo=pypi" alt="PyPI supported Python versions">
</a>
<a href="https://github.com/ImNimboss/uberduck/issues" target="_blank" rel="noopener noreferrer">
<img src="https://img.shields.io/github/issues/ImNimboss/uberduck?color=9cf&logo=github" alt="Number of open GitHub issues">
</a>
<a href="https://github.com/ImNimboss/uberduck/contributors" target="_blank" rel="noopener noreferrer">
<img src="https://img.shields.io/github/contributors/ImNimboss/uberduck?color=9cf&logo=github" alt="Number of contributors">
</a>
<a href="https://discord.gg/FcxqdJ7AQq" target="_blank" rel="noopener noreferrer">
<img src="https://img.shields.io/discord/930791886522810399?color=9cf&logo=discord&label=discord" alt="Discord server">
</a>
## Description
A synchronous and asynchronous API wrapper for the [UberDuck](https://uberduck.ai) text-to-speech service with 100% coverage and top-notch utilities.
## Main features
- [x] - Synchronous support
- [x] - Asynchronous support
- [x] - Object-oriented
- [x] - Easy to use
- [x] - Utilities like file-saving, audio-playing etc. packed all in one
- [x] - Very adjustable/configurable
- [x] - Regularly maintained
- [x] - Makes the hard tasks of polling and asynchronous operations easy
## Links
* [Documentation](https://github.com/ImNimboss/uberduck/tree/main/Documentation)
* [PyPI](https://pypi.org/project/uberduck)
* [Issue Tracking](https://github.com/ImNimboss/uberduck/issues)
* [Discord server](https://discord.gg/FcxqdJ7AQq)
* [Uberduck main site](https://uberduck.ai)
## Installation and upgrades
```
pip install uberduck
```
for the stable version (recommended).
```
pip install -U uberduck
```
to update your stable version.
```
pip install git+https://github.com/ImNimboss/uberduck
```
to install it straight off of GitHub (you need git installed for this).
```
pip install -U git+https://github.com/ImNimboss/uberduck
```
to upgrade your version that you got from GitHub.
## How to use
Check [Documentation/Basics.md](https://github.com/ImNimboss/uberduck/blob/master/Documentation/Basics.md).
## Examples
Check [Documentation/Examples.md](https://github.com/ImNimboss/uberduck/blob/master/Documentation/Examples.md).
## Some credits
The idea to implement logging in this library came from [discord.py](https://github.com/Rapptz/discord.py).
The idea to use the `polling` library came from [CupOfGeo/UberDuckAPI](https://github.com/CupOfGeo/UberDuckAPI), another uberduck.ai API wrapper.
## Changelog
* `v0.0.1` - Initial release.
* `v0.0.2` - Fixed `get_voices()` and `get_voices_async()` by updating the `Voice` class to be compatible with the new voice data available from the API.
* `v0.0.3` - Moved `README.md` from `.github` to root folder due to compatibility issues with other software
* `v0.0.4` - Added attributes `added_at`, `is_primary`, `hifi_gan_vocoder`, `ml_model_id`, `speaker_id`, `language` to `Voice` class
Raw data
{
"_id": null,
"home_page": "https://github.com/ImNimboss/uberduck",
"name": "uberduck",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6.0",
"maintainer_email": "",
"keywords": "uberduck,wrapper,api,text-to-speech,async,famous,tts,texttospeech,AI,api-wrapper,api-key,api-secret",
"author": "ImNimboss",
"author_email": "nimit.grover24@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/6c/b3/fd08db2b6199a74a002d270ca7bae50bf32ef7c0adc37f04c809f9a18e92/uberduck-0.0.4.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n <img src=\"https://raw.githubusercontent.com/ImNimboss/uberduck/main/.github/assets/uberduck-logo.png\" alt=\"Uberduck Logo\">\r\n</p>\r\n\r\n# Uberduck\r\n\r\n<a href=\"https://pypi.org/project/uberduck\" target=\"_blank\" rel=\"noopener noreferrer\">\r\n <img src=\"https://img.shields.io/pypi/v/uberduck.svg?color=9cf&logo=pypi\" alt=\"PyPI Uberduck version number\">\r\n <img src=\"https://img.shields.io/pypi/dm/uberduck?color=9cf&logo=pypi\" alt=\"PyPI downloads per month\">\r\n <img src=\"https://img.shields.io/pypi/pyversions/uberduck.svg?color=9cf&logo=pypi\" alt=\"PyPI supported Python versions\">\r\n</a>\r\n<a href=\"https://github.com/ImNimboss/uberduck/issues\" target=\"_blank\" rel=\"noopener noreferrer\">\r\n <img src=\"https://img.shields.io/github/issues/ImNimboss/uberduck?color=9cf&logo=github\" alt=\"Number of open GitHub issues\">\r\n</a>\r\n<a href=\"https://github.com/ImNimboss/uberduck/contributors\" target=\"_blank\" rel=\"noopener noreferrer\">\r\n <img src=\"https://img.shields.io/github/contributors/ImNimboss/uberduck?color=9cf&logo=github\" alt=\"Number of contributors\">\r\n</a>\r\n<a href=\"https://discord.gg/FcxqdJ7AQq\" target=\"_blank\" rel=\"noopener noreferrer\">\r\n <img src=\"https://img.shields.io/discord/930791886522810399?color=9cf&logo=discord&label=discord\" alt=\"Discord server\">\r\n</a>\r\n\r\n## Description\r\n\r\nA synchronous and asynchronous API wrapper for the [UberDuck](https://uberduck.ai) text-to-speech service with 100% coverage and top-notch utilities.\r\n\r\n## Main features\r\n\r\n- [x] - Synchronous support\r\n- [x] - Asynchronous support\r\n- [x] - Object-oriented\r\n- [x] - Easy to use\r\n- [x] - Utilities like file-saving, audio-playing etc. packed all in one\r\n- [x] - Very adjustable/configurable\r\n- [x] - Regularly maintained\r\n- [x] - Makes the hard tasks of polling and asynchronous operations easy\r\n\r\n## Links\r\n\r\n* [Documentation](https://github.com/ImNimboss/uberduck/tree/main/Documentation)\r\n* [PyPI](https://pypi.org/project/uberduck)\r\n* [Issue Tracking](https://github.com/ImNimboss/uberduck/issues)\r\n* [Discord server](https://discord.gg/FcxqdJ7AQq)\r\n* [Uberduck main site](https://uberduck.ai)\r\n\r\n\r\n## Installation and upgrades\r\n\r\n```\r\npip install uberduck\r\n```\r\nfor the stable version (recommended).\r\n\r\n```\r\npip install -U uberduck\r\n```\r\nto update your stable version.\r\n\r\n```\r\npip install git+https://github.com/ImNimboss/uberduck\r\n```\r\nto install it straight off of GitHub (you need git installed for this).\r\n\r\n```\r\npip install -U git+https://github.com/ImNimboss/uberduck\r\n```\r\nto upgrade your version that you got from GitHub.\r\n\r\n## How to use\r\n\r\nCheck [Documentation/Basics.md](https://github.com/ImNimboss/uberduck/blob/master/Documentation/Basics.md).\r\n\r\n## Examples\r\n\r\nCheck [Documentation/Examples.md](https://github.com/ImNimboss/uberduck/blob/master/Documentation/Examples.md).\r\n\r\n## Some credits\r\n\r\nThe idea to implement logging in this library came from [discord.py](https://github.com/Rapptz/discord.py).\r\n\r\nThe idea to use the `polling` library came from [CupOfGeo/UberDuckAPI](https://github.com/CupOfGeo/UberDuckAPI), another uberduck.ai API wrapper.\r\n\r\n## Changelog\r\n\r\n* `v0.0.1` - Initial release.\r\n* `v0.0.2` - Fixed `get_voices()` and `get_voices_async()` by updating the `Voice` class to be compatible with the new voice data available from the API.\r\n* `v0.0.3` - Moved `README.md` from `.github` to root folder due to compatibility issues with other software\r\n* `v0.0.4` - Added attributes `added_at`, `is_primary`, `hifi_gan_vocoder`, `ml_model_id`, `speaker_id`, `language` to `Voice` class\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A synchronous and asynchronous API wrapper for the UberDuck text-to-speech service (https://uberduck.ai) with 100% coverage and top-notch utilities.",
"version": "0.0.4",
"split_keywords": [
"uberduck",
"wrapper",
"api",
"text-to-speech",
"async",
"famous",
"tts",
"texttospeech",
"ai",
"api-wrapper",
"api-key",
"api-secret"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6cb3fd08db2b6199a74a002d270ca7bae50bf32ef7c0adc37f04c809f9a18e92",
"md5": "c0b3ba13994e3305c5fb1e823c5142e7",
"sha256": "35205d9d0c97284d707a0c107f0b2278fc0141f8bbb777ae68727c6e2fbfc32f"
},
"downloads": -1,
"filename": "uberduck-0.0.4.tar.gz",
"has_sig": false,
"md5_digest": "c0b3ba13994e3305c5fb1e823c5142e7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6.0",
"size": 10758,
"upload_time": "2023-04-20T11:28:19",
"upload_time_iso_8601": "2023-04-20T11:28:19.207481Z",
"url": "https://files.pythonhosted.org/packages/6c/b3/fd08db2b6199a74a002d270ca7bae50bf32ef7c0adc37f04c809f9a18e92/uberduck-0.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-20 11:28:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "ImNimboss",
"github_project": "uberduck",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "uberduck"
}