Metadata-Version: 2.1
Name: supertts
Version: 0.0.19
Summary: A super TTS package supporting multiple providers.
Author: Aman Kumar
Author-email: 2000.aman.sinha@gmail.com
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai
Provides-Extra: test
Requires-Dist: python-dotenv; extra == "test"

## SuperTTS

#### Star the repository if this was useful. ⭐️

[![PyPI version](https://badge.fury.io/py/supertts.svg)](https://badge.fury.io/py/supertts)
[![Downloads](https://pepy.tech/badge/supertts)](https://pepy.tech/project/supertts)
[![Downloads](https://pepy.tech/badge/supertts/month)](https://pepy.tech/project/supertts/month)
[![Downloads](https://pepy.tech/badge/supertts/week)](https://pepy.tech/project/supertts/week)

![GitHub license](https://img.shields.io/github/license/onlyoneaman/supertts)

Single TTS Package to use multiple TTS engines.

## Installation

```bash
pip install supertts
```

## Usage

Add Keys to Environment Variables
```bash
# For Openai
export OPENAI_API_KEY="YOUR_OPENAI_API_KEY"

# For Azure
export AZURE_KEY="YOUR_AZURE_KEY"
export AZURE_REGION="YOUR_AZURE_REGION"
```

TTS
```python
from supertts import SuperTTS

supertts = SuperTTS()
supertts.tts("Hello World")
```

Voices
```python
from supertts import SuperTTS

supertts = SuperTTS()
supertts.voices()
```

### Configuration

#### tts

Openai TTS
- voice: Voice to use for TTS (Default: "alloy")
- model: Model to use for TTS (Default: "tts-1")

```python
from supertts import SuperTTS

supertts = SuperTTS()

supertts.tts("Hello World", model="tts-1-hd")

supertts.tts("Hello World", voice="nova")

supertts.tts("Hello World", model="tts-1-hd", voice="nova")
```


## Supported TTS Engines

- Openai
- Azure

### Upcoming TTS Engines

- Google

## License

MIT

## Author

[Aman](https://amankumar.ai) | [X (Twitter)](https://twitter.com/onlyoneaman)

Enjoy using SuperTTS! 🚀
