🎙️ Supernal TTS

High-performance Text-to-Speech API with multi-provider support, intelligent caching, and real-time audio generation.

Development Status

Supernal TTS is currently in active development. While functional, some features may be incomplete or subject to change. We appreciate your patience as we work to deliver the best TTS experience possible!

✨ Features

• 🚀 Multi-Provider Support - OpenAI, Cartesia, Azure, and Mock providers
• ⚡ Ultra-Fast Performance - Low latency latency with Cartesia
• 💾 Intelligent Caching - Automatic content-based caching
• 🔒 Production Ready - Authentication, rate limiting, security headers
• 🎯 Easy Integration - REST API, JavaScript SDK, and web widget
• 💰 Cost Optimization - Provider comparison and cost estimation

🚀 Quick Start

1. Install and Run

# Clone the repository
git clone https://github.com/supernalintelligence/supernal-nova.git
cd supernal-nova/families/supernal-tts

# Install dependencies
npm install

# Start the server (uses mock provider by default)
npm run dev

The API will be available at http://localhost:3030

2. Test with Mock Provider

curl -X POST https://tts.supernal.ai/api/v1/generate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world!",
    "options": {
      "provider": "mock"
    }
  }'

3. Add Real Providers

Create a .env file:

# OpenAI (recommended for quality)
OPENAI_API_KEY=sk-...

# Cartesia (recommended for speed)
CARTESIA_API_KEY=...

# Azure (recommended for budget)
AZURE_API_KEY=...
AZURE_REGION=eastus

4. Generate Real Audio

curl -X POST https://tts.supernal.ai/api/v1/generate \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to Supernal TTS!",
    "options": {
      "provider": "openai",
      "voice": "fable"
    }
  }'

🎯 Provider Comparison

Provider	Latency	Cost/1M chars	Best For	Key Feature
mock	500ms	$0	Testing	No API key needed
openai	200ms	$15-30	Quality	6 premium voices
cartesia	Low latency	~$24	Real-time	Emotion control
azure	300ms	$0-16	Budget	500K free tier

📚 Next Steps

• 📖 API Reference - Complete API documentation
• ⚡ Quick Reference - Commands and examples
• 🔒 Security Guide - Production deployment
• 🎨 Widget Guide - Web integration
• 📦 Examples - Integration examples

🎮 Interactive Demo

Try the live demo:

• 🎙️ Widget Demo - Interactive examples of TTS widgets in action
• 📚 Documentation - Complete integration guide

# Or run comparison tests locally
./demo-scripts/compare-all-providers.sh "Test message"

💡 Use Cases

• Blog Audio - Convert articles to audio
• E-learning - Course narration
• Accessibility - Screen reader enhancement
• Chatbots - Voice responses
• Podcasts - Automated narration
• Games - Character voices

🤝 Support

• GitHub Issues
• Documentation
• Email: support@supernal.ai

---

🎧 Try It Now

Development Preview

This TTS widget is currently under active development. Features may not work perfectly and are subject to change. We're working hard to improve the experience!

Welcome to Supernal TTS! This is a live demo of our text-to-speech widget using eSpeak (our free, open-source provider). Click the button below to hear this text spoken aloud with real speech synthesis.

---

Ready to get started? Check out the API Reference or jump to the Quick Reference for common patterns.