elizaos--eliza/plugins/plugin-edge-tts

@elizaos/plugin-edge-tts

Free text-to-speech plugin for elizaOS using Microsoft Edge TTS. No API key required.

Features

• Free: No API key or payment required
• High Quality: Uses Microsoft's neural TTS voices (same as Edge browser)
• Multiple Languages: Supports 40+ languages with natural-sounding voices
• Configurable: Adjustable rate, pitch, and volume
• OpenAI Compatible: Maps OpenAI voice names (alloy, nova, etc.) to Edge TTS voices

Installation

npm install @elizaos/plugin-edge-tts

Usage

As elizaOS Plugin

import { edgeTTSPlugin } from "@elizaos/plugin-edge-tts";

const runtime = new AgentRuntime({
  plugins: [edgeTTSPlugin],
  // ... other config
});

// Use via runtime
const audio = await runtime.useModel(ModelType.TEXT_TO_SPEECH, "Hello world!");

Environment Variables

All configuration is optional:

Variable	Default	Description
EDGE_TTS_VOICE	en-US-MichelleNeural	Voice ID
EDGE_TTS_LANG	en-US	Language code
EDGE_TTS_OUTPUT_FORMAT	audio-24khz-48kbitrate-mono-mp3	Output format
EDGE_TTS_RATE	-	Rate adjustment (e.g., +10%, -5%)
EDGE_TTS_PITCH	-	Pitch adjustment (e.g., +5Hz, -10Hz)
EDGE_TTS_VOLUME	-	Volume adjustment (e.g., +20%, -10%)
EDGE_TTS_PROXY	-	HTTP proxy URL
EDGE_TTS_TIMEOUT_MS	30000	Request timeout

Popular Voices

English (US)

• en-US-MichelleNeural - Female (default)
• en-US-GuyNeural - Male
• en-US-JennyNeural - Female
• en-US-AriaNeural - Female
• en-US-DavisNeural - Male
• en-US-ChristopherNeural - Male

English (UK)

• en-GB-SoniaNeural - Female
• en-GB-RyanNeural - Male

Other Languages

• de-DE-KatjaNeural - German Female
• fr-FR-DeniseNeural - French Female
• es-ES-ElviraNeural - Spanish Female
• ja-JP-NanamiNeural - Japanese Female
• zh-CN-XiaoxiaoNeural - Chinese Female
• ko-KR-SunHiNeural - Korean Female

OpenAI Voice Mapping

For compatibility with OpenAI's TTS API, the following voice names are mapped:

OpenAI Voice	Edge TTS Voice
alloy	en-US-GuyNeural
echo	en-US-ChristopherNeural
fable	en-GB-RyanNeural
onyx	en-US-DavisNeural
nova	en-US-JennyNeural
shimmer	en-US-AriaNeural

Browser Support

Edge TTS is not available in browser environments because it requires:

• Node.js file system access
• WebSocket connections that browsers don't support for this service

For browser TTS, use @elizaos/plugin-elevenlabs or @elizaos/plugin-openai instead.