> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipecat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# RNNoiseFilter

> Audio noise suppression filter using RNNoise recurrent neural network

## Overview

`RNNoiseFilter` is an audio processor that reduces background noise in real-time audio streams using RNNoise, a recurrent neural network for audio noise reduction. It inherits from `BaseAudioFilter` and processes audio frames via the `pyrnnoise` library.

RNNoise is a free, open-source noise suppression solution that requires no API keys or external services.

## Installation

The RNNoise filter requires additional dependencies:

```bash theme={null}
uv add "pipecat-ai[rnnoise]"
```

## Constructor Parameters

<ParamField path="resampler_quality" type="str" default="&#x22;QQ&#x22;">
  Quality of the internal resampler used when the transport sample rate differs
  from 48kHz. One of `"VHQ"` (Very High Quality), `"HQ"` (High Quality), `"MQ"`
  (Medium Quality), `"LQ"` (Low Quality), or `"QQ"` (Quick). Defaults to `"QQ"`
  for lowest latency.
</ParamField>

## Input Frames

<ParamField path="FilterEnableFrame" type="Frame">
  Specific control frame to toggle filtering on/off

  ```python theme={null}
  from pipecat.frames.frames import FilterEnableFrame

  # Disable noise suppression
  await task.queue_frame(FilterEnableFrame(False))

  # Re-enable noise suppression
  await task.queue_frame(FilterEnableFrame(True))
  ```
</ParamField>

## Usage Example

```python theme={null}
from pipecat.audio.filters.rnnoise_filter import RNNoiseFilter
from pipecat.transports.services.daily import DailyTransport, DailyParams

transport = DailyTransport(
    room_url,
    token,
    "Respond bot",
    DailyParams(
        audio_in_enabled=True,
        audio_in_filter=RNNoiseFilter(),  # Enable RNNoise noise suppression
        audio_out_enabled=True,
    ),
)
```

## Notes

* No API key or external service required (fully local processing)
* RNNoise operates at 48kHz internally; automatic resampling is applied for other sample rates
* Handles 16-bit PCM audio format
* Can be dynamically enabled/disabled via `FilterEnableFrame`
* Buffers audio to match RNNoise's required frame length (480 samples)
* When resampling is needed, uses SOXR (install with `uv add "pipecat-ai[soxr]"`)