A reference integration between Teler and Gemini in Node, based on Media Streaming Bridge over WebSockets.

Teler is a programmable voice API by FreJun. It handles carriers, phone numbers, and real-time audio streaming so you can connect AI models directly to phone calls. → frejun.ai

1. Clone and configure:

   git clone https://github.com/frejun-tech/teler-gemini-node-bridge.git
   cd teler-gemini-node-bridge
   cp .env.example .env
   # Edit .env with your actual values

2. Run with Docker:

   docker compose up -d --build

• GET / - Health check with server domain and provider status
• GET /health - Service status
• GET /ngrok-status - Current ngrok status and URL
• POST /api/v1/calls/initiate-call - Start a new call
• POST /api/v1/calls/flow - Get call flow configuration
• WebSocket /api/v1/calls/media-stream - Audio streaming
• POST /api/v1/webhooks/receiver - Teler webhook receiver

curl -X POST "http://localhost:8000/api/v1/calls/initiate-call" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+1234567890",
    "to_number": "+0987654321"
  }'

• Gemini Live API Integration - Direct integration with Google's Gemini Live API
• Dynamic ngrok URL detection - Automatically detects current ngrok domain
• Audio buffering - Buffers audio chunks before sending to Gemini for optimal performance
• Sample rate conversion - High-quality conversion between Gemini (24kHz output) and Teler (8kHz required for playback)
• Real-time streaming - WebSocket-based audio streaming between Teler and Gemini
• High-quality audio processing - Uses scipy for professional-grade audio resampling