GedeonNzemba/live-translation

TypeScript

0

1 commits

updated Feb 3, 2026

See the code

README

Live Translation System

Real-time sermon translation system that converts English speech to French audio in real-time.

Features

  • Speech-to-Text: Deepgram Nova-2 with sermon-optimized keywords
  • Translation: DeepL API (500K chars/month free)
  • Text-to-Speech: Microsoft Edge TTS (100% FREE neural voices)
  • Real-time: WebSocket-based streaming pipeline
  • Low Latency: Optimized buffering for responsive translations

Architecture

Audio Input → Deepgram STT → DeepL Translation → Edge TTS → Audio Output
     ↓              ↓               ↓                ↓
  WebSocket    Nova-2 Model    EN → FR         Neural Voice

Quick Start

Prerequisites

  • Node.js 18+
  • Deepgram API key (for STT)
  • DeepL API key (free tier available)

Installation

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Add your API keys to .env
# DEEPGRAM_API_KEY=your_key_here
# DEEPL_API_KEY=your_key_here

# Start development server
npm run dev

Frontend

cd frontend
npm install
npm run dev

Configuration

Edit .env to configure:

VariableDescriptionDefault
DEEPGRAM_API_KEYDeepgram API key for STTRequired
DEEPL_API_KEYDeepL API key for translationRequired
TTS_PROVIDERTTS provider (edge/deepgram)edge
SOURCE_LANGUAGESource languageen
TARGET_LANGUAGETarget languagefr
PORTServer port3001

Cost Estimate

ServiceCost
Deepgram STT~$0.0043/min
DeepLFREE (500K chars/month)
Edge TTSFREE

~$2.60 per 10-hour sermon

Project Structure

src/
├── core/           # Core utilities (logger, event bus)
├── providers/      # STT, Translation, TTS providers
│   ├── stt/        # Deepgram STT
│   ├── translation/# DeepL
│   └── tts/        # Edge TTS, Deepgram TTS
├── services/       # Pipeline orchestrator, session manager
├── server/         # HTTP & WebSocket servers
└── types/          # TypeScript types

frontend/           # React/Vite frontend

License

MIT

Contributors

GedeonNzemba

1 commits

GedeonNzemba/live-translation

TypeScript

0

1 commits

updated Feb 3, 2026

See the code

README

Live Translation System

Real-time sermon translation system that converts English speech to French audio in real-time.

Features

  • Speech-to-Text: Deepgram Nova-2 with sermon-optimized keywords
  • Translation: DeepL API (500K chars/month free)
  • Text-to-Speech: Microsoft Edge TTS (100% FREE neural voices)
  • Real-time: WebSocket-based streaming pipeline
  • Low Latency: Optimized buffering for responsive translations

Architecture

Audio Input → Deepgram STT → DeepL Translation → Edge TTS → Audio Output
     ↓              ↓               ↓                ↓
  WebSocket    Nova-2 Model    EN → FR         Neural Voice

Quick Start

Prerequisites

  • Node.js 18+
  • Deepgram API key (for STT)
  • DeepL API key (free tier available)

Installation

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

# Add your API keys to .env
# DEEPGRAM_API_KEY=your_key_here
# DEEPL_API_KEY=your_key_here

# Start development server
npm run dev

Frontend

cd frontend
npm install
npm run dev

Configuration

Edit .env to configure:

VariableDescriptionDefault
DEEPGRAM_API_KEYDeepgram API key for STTRequired
DEEPL_API_KEYDeepL API key for translationRequired
TTS_PROVIDERTTS provider (edge/deepgram)edge
SOURCE_LANGUAGESource languageen
TARGET_LANGUAGETarget languagefr
PORTServer port3001

Cost Estimate

ServiceCost
Deepgram STT~$0.0043/min
DeepLFREE (500K chars/month)
Edge TTSFREE

~$2.60 per 10-hour sermon

Project Structure

src/
├── core/           # Core utilities (logger, event bus)
├── providers/      # STT, Translation, TTS providers
│   ├── stt/        # Deepgram STT
│   ├── translation/# DeepL
│   └── tts/        # Edge TTS, Deepgram TTS
├── services/       # Pipeline orchestrator, session manager
├── server/         # HTTP & WebSocket servers
└── types/          # TypeScript types

frontend/           # React/Vite frontend

License

MIT

Contributors

GedeonNzemba

1 commits

Languages

TypeScript

93.3%

HTML

6.4%