​

Overview

This guide will walk you through setting up and using Krisp’s noise reduction capabilities in your Pipecat application. Krisp provides professional-grade noise cancellation that can significantly improve audio quality in real-time communications.

To use Krisp’s noise cancellation, you’ll need to obtain their SDK and models through a Krisp developer account. Our Pipecat Krisp module simplifies the integration process, which we’ll cover in this guide.

​

Walkthrough

​

Get Access to Krisp SDK and Models

1. Create a Krisp developers account at krisp.ai/developers
2. Download the Krisp Desktop SDK (v7) that matches your platform:
   • Linux: Desktop SDK v7.0.2: Linux
   • macOS (ARM): Desktop SDK v7.0.1: Mac ARM
   • macOS (Intel): Desktop SDK v7.0.1: Mac Intel
   • Windows(ARM): Desktop SDK v7.0.2: Windows ARM
   • Windows (x64): Desktop SDK v7.0.2: Windows
3. Download the corresponding models. We recommend trying the Background Voice Cancellation model. Recommended model for each platform:
   • Linux (ARM): hs.c6.f.s.de56df.kw
   • Mac (ARM): hs.c6.f.s.de56df.kw
   • Linux (x86_64): hs.c6.f.s.de56df.kw
   • Mac (x86_64): hs.c6.f.s.de56df.kw
   • Windows (x86_64): hs.c6.f.s.de56df.kw

​

Install build dependencies

The pipecat-ai-krisp module is a python wrapper around Krisp’s C++ SDK. To build the module, you’ll need to install the following dependencies:

# Using Homebrew
brew install cmake pybind11

# Using Homebrew
brew install cmake pybind11

# Using apt
sudo apt-get update
sudo apt-get install cmake python3-dev pybind11-dev g++

# Using Chocolatey
choco install cmake
# pybind11 will be installed via pip during the build process

# OR using Visual Studio
# 1. Install Visual Studio with C++ development tools
# 2. Install CMake from https://cmake.org/download/
# pybind11 will be installed via pip during the build process

​

Install the pipecat-ai-krisp module

In your Pipecat repo, activate your virtual environment:

python3 -m venv venv
source venv/bin/activate

python3 -m venv venv
source venv/bin/activate

# Using PowerShell
python -m venv venv
.\venv\Scripts\Activate.ps1

# OR using Command Prompt
python -m venv venv
.\venv\Scripts\activate.bat

# OR using Git Bash
python -m venv venv
source venv/Scripts/activate

Export the path to your Krisp SDK and model files:

# Add to your .env file or shell configuration
export KRISP_SDK_PATH=/PATH/TO/KRISP/SDK
export KRISP_MODEL_PATH=/PATH/TO/KRISP/MODEL.kef

# Add to your .env file or shell configuration
export KRISP_SDK_PATH=/PATH/TO/KRISP/SDK
export KRISP_MODEL_PATH=/PATH/TO/KRISP/MODEL.kef

# Using PowerShell
$env:KRISP_SDK_PATH = "C:\PATH\TO\KRISP\SDK"
$env:KRISP_MODEL_PATH = "C:\PATH\TO\KRISP\MODEL.kef"

# OR using Command Prompt
set KRISP_SDK_PATH=C:\PATH\TO\KRISP\SDK
set KRISP_MODEL_PATH=C:\PATH\TO\KRISP\MODEL.kef

export KRISP_MODEL_PATH=./krisp/hs.c6.f.s.de56df.kw

export KRISP_MODEL_PATH=./krisp/hs.c6.f.s.de56df.kw

KRISP_MODEL_PATH=./krisp/outbound-bvc-models-fp16/hs.c6.f.s.de56df.bucharest.kef

$env:KRISP_MODEL_PATH="C:\krisp\outbound-bvc-models-fp32\hs.c6.f.s.de56df.bucharest.kef"

Next, install the pipecat-ai[krisp] module, which will automatically build the pipecat-ai-krisp python wrapper module:

pip install "pipecat-ai[krisp]"

​

Test the integration

You can now test the Krisp integration. The easiest way to do this is to run the foundational example: 07p-interruptible-krisp.py.

python examples/foundational/07p-interruptible-krisp.py -u YOUR_DAILY_ROOM_URL

​

Important for macOS users

If you’re running on macOS you may receive a security warning about running the script. This is expected. You can allow access by going to System Settings > Privacy & Security then click Allow Anyway to permit the example to run.

After allowing and re-running, you may get a pop-up asking for permission. Select Open Anyway to run the script.

​

Usage Example

Here’s a basic example of how to add Krisp noise reduction to your Pipecat pipeline:

from pipecat.audio.filters.krisp_filter import KrispFilter
from pipecat.transports.services.daily import DailyParams, DailyTransport

# Add to transport configuration
transport = DailyTransport(
    room_url,
    token,
    "Audio Bot",
    DailyParams(
        audio_in_filter=KrispFilter(),  # Enable Krisp noise reduction
        audio_in_enabled=True,
        audio_out_enabled=True,
        vad_analyzer=SileroVADAnalyzer(),
    ),
)

​

Troubleshooting

Common issues and solutions:

1. Missing Dependencies

Error: Missing module: pipecat_ai_krisp

Solution: Ensure you’ve installed with the krisp extra: pip install "pipecat-ai[krisp]"

2. Model Path Not Found

Error: Model path for KrispAudioProcessor must be provided

Solution: Set the KRISP_MODEL_PATH environment variable or provide it in the constructor

3. SDK Path Issues

Error: Cannot find Krisp SDK

Solution: Verify KRISP_SDK_PATH points to a valid Krisp SDK installation

​

Additional Resources

• KrispFilter Reference Documentation
• Example Application