Koala Audio Filter

Overview

KoalaFilter is an audio processor that reduces background noise in real-time audio streams using Koala Noise Suppression technology from Picovoice. It inherits from BaseAudioFilter and processes audio frames to improve audio quality by removing unwanted noise. To use Koala, you need a Picovoice access key. Get started at Picovoice Console.

Installation

The Koala filter requires additional dependencies:

uv add "pipecat-ai[koala]"

You’ll also need to set up your Koala access key as an environment variable: KOALA_ACCESS_KEY

Constructor Parameters

str

required

Picovoice access key for using the Koala noise suppression service

Input Frames

Frame

Specific control frame to toggle filtering on/off. Queue the frame into the pipeline to toggle the filter used as audio_in_filter:

from pipecat.frames.frames import FilterEnableFrame

# Disable noise reduction
await worker.queue_frame(FilterEnableFrame(False))

# Re-enable noise reduction
await worker.queue_frame(FilterEnableFrame(True))

Usage Example

from pipecat.audio.filters.koala_filter import KoalaFilter

transport = DailyTransport(
    room_url,
    token,
    "Respond bot",
    DailyParams(
        audio_in_filter=KoalaFilter(access_key=os.getenv("KOALA_ACCESS_KEY")), # Enable Koala noise reduction
        audio_in_enabled=True,
        audio_out_enabled=True,
    ),
)

Notes

Requires Picovoice access key
Supports real-time audio processing
Handles 16-bit PCM audio format
Can be dynamically enabled/disabled
Maintains audio quality while reducing noise
Efficient processing for low latency
Automatically handles audio frame buffering
The input sample rate must match Koala’s sample rate (16000 Hz); at any other rate the filter passes audio through unfiltered

Get Started

Pipecat Server

Client SDKs

Pipecat Flows

Pipecat Cloud

CLI

Pipecat Context Hub

Koala Audio Filter

Overview

Installation

Constructor Parameters

Input Frames

Usage Example

Notes

​Overview

​Installation

​Constructor Parameters

​Input Frames

​Usage Example

​Notes

Overview

Installation

Constructor Parameters

Input Frames

Usage Example

Notes