Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ImNimboss/uberduck
A synchronous and asynchronous API wrapper for the UberDuck text-to-speech service (https://uberduck.ai) with 100% coverage and top-notch utilities.
https://github.com/ImNimboss/uberduck
api-wrapper async asynchronous asyncio easy-to-use famous-people python python3 synchronous text-to-speech text-to-speech-python3 uberduck uberduck-ai
Last synced: 7 days ago
JSON representation
A synchronous and asynchronous API wrapper for the UberDuck text-to-speech service (https://uberduck.ai) with 100% coverage and top-notch utilities.
- Host: GitHub
- URL: https://github.com/ImNimboss/uberduck
- Owner: ImNimboss
- License: mit
- Created: 2022-03-10T09:23:42.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-17T09:04:34.000Z (over 1 year ago)
- Last Synced: 2024-04-24T19:03:50.706Z (7 months ago)
- Topics: api-wrapper, async, asynchronous, asyncio, easy-to-use, famous-people, python, python3, synchronous, text-to-speech, text-to-speech-python3, uberduck, uberduck-ai
- Language: Python
- Homepage:
- Size: 66.4 KB
- Stars: 22
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Uberduck
## 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
* `v0.0.5` - Updated dependencies to support `Literal` in python versions below 3.8 and added `simpleaudio` installation