Skip to main content
Community-maintained integration. This service is built and maintained by wavix. Pipecat does not test or officially support it. Please report issues and request changes on the source repository. Learn more about community integrations.

Overview

WavixFrameSerializer converts audio between Pipecat frames and the Wavix WebSocket media stream format, enabling bidirectional audio streaming between a Pipecat pipeline and Wavix telephony. It is used with FastAPIWebsocketTransport to build voice-enabled applications over Wavix calls.

Source Repository

Source code, examples, and issues for the Wavix integration

PyPI Package

The pipecat-wavix package on PyPI

Wavix

Wavix telephony platform and developer documentation

Create Account

Sign up for a Wavix account and provision a phone number

Installation

This is a community-maintained package distributed separately from pipecat-ai:

Prerequisites

Wavix Account Setup

Before using the Wavix serializer, you need:
  1. Wavix Account: Sign up at Wavix
  2. Phone Number: Provision a Wavix phone number with voice capabilities

Required Environment Variables

  • WAVIX_API_KEY: Your Wavix API key
The example bots in the source repository also use OPENAI_API_KEY, DEEPGRAM_API_KEY, and CARTESIA_API_KEY for the speech and LLM services in the pipeline.

Configuration

The serializer is constructed with a stream_id and an optional InputParams object.
str
required
The Wavix media stream identifier, used to address outbound messages.
WavixFrameSerializer.InputParams
default:"None"
Serializer configuration. Defaults to WavixFrameSerializer.InputParams() when not provided. See Input Parameters below.

Input Parameters

Configuration passed via the params constructor argument using WavixFrameSerializer.InputParams(...).
Wavix uses a fixed media format: PCM16, 24 kHz, mono, little-endian, 20 ms frames. See the source repository for the authoritative, up-to-date list of parameters.

Usage

Wire the serializer into a FastAPIWebsocketTransport:
Outbound audio is automatically converted to Wavix’s required format: PCM16, 24 kHz, mono, little-endian, 20 ms frames. See the source repository for complete server.py and bot.py examples, including webhook handling and call control.

Compatibility

Built against pipecat-ai==0.0.105 (per the package dependencies). Check the source repository for the latest tested version and changelog.