openai-edge-tts

openai-edge-tts is a speech (TTS/STT) tool - Free, high-quality text-to-speech API endpoint to replace OpenAI, Azure, or ElevenLabs.

Overview

This project provides a local, OpenAI-compatible text-to-speech (TTS) API using 'edge-tts'. It emulates the OpenAI TTS endpoint ('/v1/audio/speech'), enabling users to generate speech from text with various voice options and playback speeds, just like the OpenAI API.

'edge-tts' uses Microsoft Edge's online text-to-speech service, so it is completely free.

• OpenAI-Compatible Endpoint: '/v1/audio/speech' with similar request structure and behavior. - SSE Streaming Support: Real-time audio streaming via Server-Sent Events when 'stream_format: "sse"' is specified. - Supported Voices: Maps OpenAI voices (alloy, echo, fable, onyx, nova, shimmer) to 'edge-tts' equivalents. - Flexible Formats: Supports multiple audio formats (mp3, opus, aac, flac, wav, pcm). - Adjustable Speed: Option to modify playback speed (0.25x to 4.0x). - Optional Direct Edge-TTS Voice Selection: Use either OpenAI voice mappings or specify any edge-tts voice directly.

• Docker (recommended): Docker and Docker Compose for containerized setup. - Python (optional): For local development, install dependencies in 'requirements.txt'. - ffmpeg (optional): Required for audio format conversion. Optional if sticking to mp3.

2. Environment Variables: Create a '.env' file in the root directory with the following variables:

Run with '-d' to run docker compose in "detached mode", meaning it will run in the background and free up your terminal.

openai-edge-tts is open-source, written primarily in Python, with 1,918 GitHub stars under the GPL-3.0 license. The latest release is v2.0.0 (2024-12-28).

Key capabilities

From the project's documentation:

• OpenAI-Compatible Endpoint: /v1/audio/speech with similar request structure and behavior.
• SSE Streaming Support: Real-time audio streaming via Server-Sent Events when stream_format: "sse" is specified.
• Supported Voices: Maps OpenAI voices (alloy, echo, fable, onyx, nova, shimmer) to edge-tts equivalents.
• Flexible Formats: Supports multiple audio formats (mp3, opus, aac, flac, wav, pcm).
• Adjustable Speed: Option to modify playback speed (0.25x to 4.0x).
• Docker (recommended): Docker and Docker Compose for containerized setup.

How it fits a local-AI stack

openai-edge-tts runs on your own hardware, so pair it with a model and a GPU sized to your needs. Use the VRAM calculator to pick a model that fits your card, and see what you can run for hardware guidance. Related speech (TTS/STT) tools in the directory:

• Kokoro TTS
• Miso One / MisoTTS
• Piper TTS
• Sherpa Onnx

Sources

• Source code & docs: travisvn/openai-edge-tts
• Official website: https://tts.travisvn.com

Stats from GitHub, 2026-06-08.