Home/Speech & Audio/openai-edge-tts

openai-edge-tts

travisvn/openai-edge-tts

Free text-to-speech API for edge computing

GitHub Website

GraphCanon updated 3w · GitHub synced 3w · 31 views this month

2.0k stars304 forksLast push 1y Python GPL-3.0

Decision brief

openai-edge-tts is a text-to-speech API endpoint for edge computing. It replaces cloud-based solutions like OpenAI.

Good fit when

You need text-to-speech services locally without relying on the internet or external APIs.
Looking to reduce latency and improve privacy by keeping data local.

Avoid when

Requires self-management of a Docker environment for setup and maintenance.
Does not support as many out-of-the-box audio formats without including FFmpeg.

Observed Jul 17, 2026 · Source: enrich:decision_facts

openai-edge-tts alternatives Trust report

Verify the decision

Adoption

Package downloads where a registry match exists. GitHub stars (2,007) are secondary evidence.

Docker Hub pulls (30d): 234,821·Docker Hub API·3w

Maintenance and security

Full trust report

Maintenance: Dormant (392d since push); As of 3w
Provenance: Not a fork · Personal account; As of 3w
Security (OSV): No criticals; As of 1mo

Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.

Install

pip install openai-edge-tts

PyPI

Similar tools

Same-category neighbours. No typed graph edges are catalogued for this tool yet.

edge-tts

Python library to access Microsoft Edge's online text-to-speech service without requiring Microsoft Edge or Windows or an API key

12k★

voice-pro

Gradio WebUI for TTS and voice cloning with audio processing capabilities

11k★

AudioGPT

AudioGPT: Understanding and Generating Speech, Music, Sound, and Talking Head

10k★

Evidence and technical details

Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.

Overview

Provides high-quality TTS services locally to replace cloud-based TTS solutions like OpenAI.

Capability facts

Deploy: Self-host
Source: dockerfile:Dockerfile · Jul 29, 2026
Docker: Dockerfile present
Source: dockerfile:Dockerfile · Jul 29, 2026
Languages: python
Source: github.language · Jul 29, 2026

Compatibility

Sourced claims from the README excerpt - not unsourced marketing copy.

Python runtimePython

Source: README excerpt (regex_v1, Jul 29, 2026)

pip install -r requirements.txt

Source link

README

⚡️ Quick start

The simplest way to get started without having to configure anything is to run the command below

docker run -d -p 5050:5050 travisvn/openai-edge-tts:latest

This will run the service at port 5050 with all the default configs

(Docker required, obviously)

Installation

Clone the Repository:

git clone https://github.com/travisvn/openai-edge-tts.git
cd openai-edge-tts

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

API_KEY=your_api_key_here
PORT=5050

DEFAULT_VOICE=en-US-AvaNeural
DEFAULT_RESPONSE_FORMAT=mp3
DEFAULT_SPEED=1.0

DEFAULT_LANGUAGE=en-US

REQUIRE_API_KEY=True
REMOVE_FILTER=False
EXPAND_API=True
DETAILED_ERROR_LOGGING=True

Or, copy the default .env.example with the following:

cp .env.example .env

Run with Docker Compose (recommended):

docker compose up --build

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

docker compose up -d

Building Locally with FFmpeg using Docker Compose

By default, docker compose up --build creates a minimal image without ffmpeg. If you're building locally (after cloning this repository) and need ffmpeg for audio format conversions (beyond MP3), you can include it in the build.

This is controlled by the INSTALL_FFMPEG_ARG build argument. Set this environment variable to true in one of these ways:

Prefixing the command:

INSTALL_FFMPEG_ARG=true docker compose up --build

Adding to your .env file: Add this line to the .env file in the project root:
```
INSTALL_FFMPEG_ARG=true
```
Then, run docker compose up --build.
Exporting in your shell environment: Add export INSTALL_FFMPEG_ARG=true to your shell configuration (e.g., ~/.zshrc, ~/.bashrc) and reload your shell. Then docker compose up --build will use it.

This is for local builds. For pre-built Docker Hub images, add the latest-ffmpeg tag to the version

docker run -d -p 5050:5050 -e API_KEY=your_api_key_here -e PORT=5050 travisvn/openai-edge-tts:latest-ffmpeg

Alternatively, run directly with Docker:

docker build -t openai-edge-tts .
docker run -p 5050:5050 --env-file .env openai-edge-tts

To run the container in the background, add -d after the docker run command:

docker run -d -p 5050:5050 --env-file .env openai-edge-tts

Access the API: Your server will be accessible at http://localhost:5050.

3. Install Dependencies

Use pip to install the required packages listed in requirements.txt:

pip install -r requirements.txt

License

This project is licensed under GNU General Public License v3.0 (GPL-3.0), and the acceptable use-case is intended to be personal use. For enterprise or non-personal use of openai-edge-tts, contact me at tts@travisvn.com

For agents

This page has a .md twin and JSON over the API.

/tools/travisvn-openai-edge-tts.md GET /api/graphcanon/tools/travisvn-openai-edge-tts GET /api/graphcanon/graph?tool=travisvn-openai-edge-tts