Registry / llm-agents / livekit-blingfire

livekit-blingfire

library1.1.0pypypi✓ verified 24d ago

livekit-blingfire provides Python bindings for the BlingFire text processing library, specifically designed to integrate with livekit-agents. It offers efficient sentence splitting and tokenization capabilities, typically used to enhance the text processing pipeline within LiveKit's AI agents. The library is part of the broader LiveKit Agents ecosystem and sees releases that often align with major livekit-agents updates, ensuring compatibility and leveraging new features.

llm-agents ai-ml

pip install livekit-blingfire

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · LIVEKIT-BLINGFIRE

livekit-blingfire

llm-agentspythonv1.1.0

Install

1.6s avg

Import

—

Disk

18MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.1.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 20MB

18MB installed

● package 18MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

BlingFireSentenceSplitter

✓ from livekit import BlingFireSentenceSplitter

✗ from livekit import BlingFireSentenceSplitter

This quickstart demonstrates how to configure `livekit-agents` to use `BlingFireSentenceSplitter` as its default sentence splitter for LLM-related text processing. Once set, any `livekit.agents.llm` components that rely on sentence splitting will automatically use BlingFire.

from livekit.plugins.blingfire import BlingFireSentenceSplitter from livekit.agents import llm # Set BlingFire as the default sentence splitter for LLM operations llm.sentence_splitter.set_splitter(BlingFireSentenceSplitter()) # Example usage of the splitter (typically used internally by agents) text = "Hello, world! How are you doing? This is a test." splitter = llm.sentence_splitter.get_splitter() sentences = splitter.split(text) for s in sentences: print(f"- {s}")

Debug

Known issues

gotchaBlingFire, the underlying library, has native components. While `livekit-blingfire` typically distributes pre-compiled wheels for common platforms, installing on less common architectures or Python versions might require a C++ compiler and associated build tools for the `blingfire` dependency.

fix

Ensure your environment has necessary build tools (e.g., `build-essential` on Debian/Ubuntu, Xcode on macOS) if wheel installation fails.

affects: All versions

gotchaThe `llm.sentence_splitter.set_splitter()` method globally configures the sentence splitter for all `livekit.agents.llm` operations within the current process. If you are running multiple agents or plugins that require different sentence splitting behaviors, this global setting could lead to unexpected interactions or race conditions.

fix

For complex scenarios with multiple agents/plugins, consider designing your agents to explicitly pass splitter instances where needed, or manage separate processes for agents requiring distinct configurations.

affects: All versions

gotchaCompatibility with `livekit-agents` versions is crucial. `livekit-blingfire` specifies `livekit-agents (>=1.0.0,<2.0.0)`. Installing incompatible versions of `livekit-agents` can lead to runtime errors or unexpected behavior due to API changes.

fix

Always install `livekit-blingfire` alongside a compatible version of `livekit-agents`. Use `pip install livekit-blingfire` to ensure dependencies are resolved correctly, or consult the `livekit-blingfire` `pyproject.toml` for the exact `livekit-agents` version range.

affects: All versions

Upgrade

Version history

1.1.0latest on PyPI · released Dec 16, 2025

Audit

Dependencies

livekit-agentsrequiredProvides the core agent framework that this plugin integrates with.

blingfirerequiredThe underlying high-performance text processing library for tokenization and sentence splitting.

Agent activity

28 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/livekit/agents ↗

packagehttps://pypi.org/project/livekit-blingfire/ ↗

docshttps://docs.livekit.io ↗