Pipecat Awaaz AI Telephony Serializer Integration

Host your Pipecat agents with Awaaz AI telephony stack.

Maintainer: Awaaz AI

Installation

pip install pipecat-awaazai

Or via uv, update your pyproject.toml:

[project]
name = "your-project"
version = "0.1.0"
dependencies = [
    "pipecat-awaazai",
    "another-package"
]

uv sync

Prerequisites

• Purchase a Phone number from Awaaz AI

Usage with Pipecat Pipeline

AwaazAIFrameSerializer convert between frames and media streams, enabling real-time communication over a websocket to host agent over Awaaz AI's telephony stack over an indian phone number

from pipecat_awaazai import AwaazAIFrameSerializer

    transport = FastAPIWebsocketTransport(
        websocket=websocket_client,
        params=FastAPIWebsocketParams(
            audio_out_enabled=True,
            add_wav_header=True,
            vad_enabled=True,
            vad_analyzer=SileroVADAnalyzer(sample_rate=8000),
            vad_audio_passthrough=True,
            serializer=AwaazAIFrameSerializer(stream_id),
            audio_out_sample_rate=8000
        ),
    )

See example.py for a complete working example including event handlers and transport setup.

Running the Example

1. Start ngrok: In a new terminal, start ngrok to tunnel the local server:

   ngrok http 7860

2. Share your ngrok endpoint url (e.g. https://foo.bar.ngrok-free.dev) with us by including it in this form; you'll get an email with a demo phone number

3. Install dependencies:

   uv sync

4. Set up your environment

   cp env.example .env

5. Run:

   uv run bot.py --transport awaazai --proxy your_ngrok_url

The bot will create a websocket that will accept connections from Awaaz AI assigned phone number. Once websocket is running, call Awaaz AI assigned phone number and you will be able to interact over the call

Compatibility

Tested with Pipecat v0.0.101

• Python 3.10+

License

BSD-2-Clause - see LICENSE

Support

• Docs: https://docs.awaaz.de/voice-hosting/custom (refer to API docs for message formats)
• Pipecat Discord: https://discord.gg/pipecat (#community-integrations)