livekit-plugins-noise-cancellation

Livekit plugin for noise cancellation of inbound AudioStream

SEE LICENSE IN https://livekit.io/legal/terms-of-service 10 个版本 Python >=3.9
安装
pip install livekit-plugins-noise-cancellation
poetry add livekit-plugins-noise-cancellation
pipenv install livekit-plugins-noise-cancellation
conda install livekit-plugins-noise-cancellation
描述

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

See: https://livekit.io/legal/terms-of-service

版本列表
0.2.5 2025-06-30
0.2.4 2025-05-15
0.2.3 2025-05-05
0.2.2 2025-05-01
0.2.1 2025-03-22
0.2.0 2025-03-19
0.1.3 2025-03-08
0.1.2 2025-03-04
0.1.1 2025-03-03
0.1.0 2025-03-03