metadata

title: TTS
emoji: 🔥
colorFrom: green
colorTo: red
sdk: gradio
sdk_version: 4.36.1
app_file: app.py
pinned: false
license: mit
hf_oauth: true
hf_oauth_expiration_minutes: 480

Getting Started

This spaces allows you to create speech audio from text. It currently works with OpenAI and Cartesia AI.

Running Locally

git clone https://huggingface.co/spaces/matdmiller/tts-openai
cd tts-openai
pip install -r requirements.txt

Next create a file tts_openai_secrets.py to hold the secrets or set them up as environment variables yourself.

import os
os.environ['OPENAI_API_KEY'] = 'sk-xxx'
os.environ["CARTESIA_API_KEY"]= 'xxx'
os.environ["ALLOWED_OAUTH_PROFILE_USERNAMES"]= '<your huggingface username>' #comma delimited
os.environ["REQUIRE_AUTH"]= 'false'

This file is included in the .gitignore so it will not be included when you publish to your repo. This is very important because the 🤗 Spaces repos are public by default and you don't want to leak your API keys.

Finally to run locally simply run:

python app.py

Cloning to run in your own 🤗 Space.

Click the ... in the top right hand corder of my Space and click Duplicate Space.

This will bring up a form that you need to fill out with the appropriate keys and settings.

Owner: Your HF Username
Visibility: Public (Or Private if you know what you're doing). By default this app is secured with 🤗 OAuth and only allows usernames you specify in the ALLOWED_OAUTH_PROFILE_USERNAMES property.
Space Hardware: Free CPU Basic is plenty of horsepower for this app becuase all of the TTS work is happening behind the API.
OPENAI_API_KEY: Input your own OpenAI API key which you can get by signing up for an account on https://platform.openai.com. This is completely separate from ChatGPT.
CARTESIA_API_KEY: Input your own Cartesia AI API key which you can obtain from https://play.cartesia.ai/subscription
ALLOWED_OAUTH_PROFILE_USERNAMES: Add a comma separated list of Hugging Face usernames that are allowed to use the space. Only usernames listed here will be allowed generate speech audio, though anyone can view the site. Ex: santa1225,clem2024. If you have a single username, don't add a comma.

Click Duplicate Space. Your new space should be created within a couple of minutes.

Additional HF Spaced Config Info: https://huggingface.co/docs/hub/spaces-config-reference