Livekit plugin for noise cancellation of inbound AudioStream
Project Links
Meta
Requires Python: >=3.9
Classifiers
Enhanced Noise Cancellation Plugin for LiveKit
Add realtime enhanced noise cancellation to inbound AudioStream. Fully compatible with LiveKit Agents.
Requires LiveKit Cloud.
Read more in the documentation
Usage
In LiveKit Agents
Include the filter in RoomInputOptions when starting your AgentSession:
from livekit.plugins import noise_cancellation
# ...
await session.start(
# ...,
room_input_options=room_io.RoomInputOptions(
noise_cancellation=noise_cancellation.BVC(),
),
)
# ...
On AudioStream
Noise cancellation can also be applied to any individual inbound AudioStream:
stream = rtc.AudioStream.from_track(
track=track,
noise_cancellation=noise_cancellation.NC(),
)
Available Models
noise_cancellation.NC()noise_cancellation.BVC()noise_cancellation.BVCTelephony()
Notes
Noise cancellation only needs to be applied once, so if you choose to apply it here you should disable noise cancellation / Krisp filter in your frontend clients.
If you experience crashes when using noise_cancellation (especially on AMD CPUs), it may be due to a failure in OpenBLAS's CPU detection. Manually setting the OPENBLAS_CORETYPE environment variable to a more conservative value (e.g., Haswell) may resolve the issue.
License
0.2.5
Jun 30, 2025
0.2.4
May 15, 2025
0.2.3
May 05, 2025
0.2.2
May 01, 2025
0.2.1
Mar 22, 2025
0.2.0
Mar 19, 2025
0.1.3
Mar 08, 2025
0.1.2
Mar 04, 2025
0.1.1
Mar 03, 2025
0.1.0
Mar 03, 2025
Wheel compatibility matrix
| Platform | Python 3 |
|---|---|
| macosx_10_9_x86_64 | |
| macosx_11_0_arm64 | |
| manylinux_2_28_aarch64 | |
| manylinux_2_28_x86_64 | |
| win_amd64 |
Files in release
livekit_plugins_noise_cancellation-0.2.5-py3-none-macosx_10_9_x86_64.whl (63.0MiB)
livekit_plugins_noise_cancellation-0.2.5-py3-none-macosx_11_0_arm64.whl (61.6MiB)
livekit_plugins_noise_cancellation-0.2.5-py3-none-manylinux_2_28_aarch64.whl (67.0MiB)
livekit_plugins_noise_cancellation-0.2.5-py3-none-manylinux_2_28_x86_64.whl (69.9MiB)
livekit_plugins_noise_cancellation-0.2.5-py3-none-win_amd64.whl (62.7MiB)
Extras:
None
Dependencies:
livekit
(>=0.21.3)