简介
Chonkie是一个用于RAG(检索增强生成)任务的轻量级、快速的文本分块库。
Chonkie 特点
- 功能丰富:提供多种分块器,满足不同的RAG应用需求。
- 支持广泛:支持多种分块器,包括TokenChunker、WordChunker、SentenceChunker、SemanticChunker和SDPMChunker。
- 轻量级:核心安装仅有9.7MB,远小于其他开源项目。
安装方法
1. 基础安装
| 安装命令 | 适用场景 | 依赖 |
|---|
pip install chonkie | 基本的token和word分块 | autotiktokenizer |
pip install chonkie[semantic] | 语义分块 | + sentence-transformers, numpy |
pip install chonkie[all] | 所有功能 | all dependencies |
2.按照依赖包进行划分chunker
| chunker种类 | default | semantic | all |
|---|
| TokenChunker | ✅ | ✅ | ✅ |
| WordChunker | ✅ | ✅ | ✅ |
| SentenceChunker | ✅ | ✅ | ✅ |
| SemanticChunker | ❌ | ✅ | ✅ |
| SDPMChunker | ❌ | ✅ | ✅ |
代码示例
1. TokenChunker示例:将文本分割成固定大小token的块。
#ImporttheTokenChunker
fromchonkieimportTokenChunker
fromautotiktokenizerimportAutoTikTokenizer
#Initializethetokenizer
tokenizer=AutoTikTokenizer.from_pretrained("gpt2")
#Initializethechunker
chunker=TokenChunker(
tokenizer=tokenizer,
chunk_size=512,
chunk_overlap=128
)
#Chunkasinglepieceoftext
chunks=chunker.chunk("Woah!Chonkie,thechunkinglibraryissocool!Ilovethetinyhippohehe.")
forchunkinchunks:
print(f"Chunk:{chunk.text}")
print(f"Tokens:{chunk.token_count}")
#Chunkabatchoftexts
texts=["Firsttexttochunk.","Secondtexttochunk."]
batch_chunks=chunker.chunk_batch(texts)
fortext_chunksinbatch_chunks:
forchunkintext_chunks:
print(f"Chunk:{chunk.text}")
print(f"Tokens:{chunk.token_count}")
#Usethechunkerasacallable
chunks=chunker("Anothertexttochunkusing__call__.")
forchunkinchunks:
print(f"Chunk:{chunk.text}")
print(f"Tokens:{chunk.token_count}")
2. WordChunker示例:根据单词/词语分割文本。
fromchonkieimportWordChunker
fromautotiktokenizerimportAutoTikTokenizer
tokenizer=AutoTikTokenizer.from_pretrained("gpt2")
chunker=WordChunker(
tokenizer=tokenizer,
chunk_size=512,
chunk_overlap=128,
mode="advanced"#'simple-基本的基于空间的分割'or'advanced-处理标点符号和特殊大小写'
)
3. SentenceChunker示例:根据句子分割文本。
fromchonkieimportSentenceChunker
fromautotiktokenizerimportAutoTikTokenizer
tokenizer=AutoTikTokenizer.from_pretrained("gpt2")
chunker=SentenceChunker(
tokenizer=tokenizer,#(可选)传入您选择的分词器,可以接受 tiktoken、tokenizer 和 transformers 分词器,优先授予 tiktoken。
chunk_size=512,#(可选)传递块的大小。默认为 tokenizer 支持的最大大小(如果有)或 512。
chunk_overlap=128,#(可选)接受 int 或 float。文本的连续块之间的重叠。默认为 min(0.25 * chunk_size, 128)。
min_sentences_per_chunk=1#每个区块的最小句子数
)
4. SemanticChunker示例:根据语义相似性分割文本。
⚠️:大多数情况下,chunk_size、token_count取决于向量化模型上下文大小,而不是生成模型上下文长度。
fromchonkieimportSemanticChunker
chunker=SemanticChunker(
embedding_model="all-minilm-l6-v2",
max_chunk_size=512,#从SemanticChunker接收的chunk的最大大小
similarity_threshold=0.7#语义分组的阈值
)
5. SDPMChunker示例:使用语义双重遍历合并方法分割文本。
通过语义双通道合并方法对内容进行分组,该方法通过使用跳过窗口对语义相似的段落进行分组,即使它们不是连续出现的。
fromchonkieimportSDPMChunker
chunker=SDPMChunker(
embedding_model="all-minilm-l6-v2",
max_chunk_size=512,
similarity_threshold=0.7,
skip_window=1#分块程序应注意的跳过窗口的大小。默认为 1。
)
设计理念
1. 核心原则
2. 为什么需要分块?
3. 如何实现快速分块?
问答回顾全文
问题1:Chonkie的TokenChunker有哪些关键参数?如何使用它进行文本分块?
- tokenizer:一个实现了编码/解码接口的分词器,可以是字符串、tokenizers.Tokenizer或tiktoken.Encoding类型。
- chunk_size:每个分块的最大token数量。
- chunk_overlap:分块之间的重叠token数量。
- 使用TokenChunker进行文本分块的示例代码:
fromchonkieimportTokenChunker
fromtokenizersimportTokenizer
tokenizer=Tokenizer.from_pretrained("gpt2")
chunker=TokenChunker(tokenizer)
chunks=chunker("Woah!Chonkie,thechunkinglibraryissocool!")
forchunkinchunks:
print(f"Chunk:{chunk.text}")
print(f"Tokens:{chunk.token_count}")
问题2:Chonkie的SemanticChunker如何实现语义相似性分组?有哪些关键参数?
- 答:SemanticChunker通过使用预训练的语义嵌入模型来计算文本片段之间的相似性,并根据相似性阈值进行分组。其关键参数包括:
- embedding_model:用于语义嵌入的模型,可以是字符串(如"all-minilm-l6-v2")或SentenceTransformer模型。
- max_chunk_size:从SemanticChunker接收的每个分块的最大大小。
- similarity_threshold:用于语义分组的相似性阈值。
- 使用SemanticChunker进行文本分块的示例代码:
fromchonkieimportSemanticChunker
chunker=SemanticChunker(embedding_model="all-minilm-l6-v2",max_chunk_size=512,similarity_threshold=0.7)
chunks=chunker("Woah!Chonkie,thechunkinglibraryissocool!")
forchunkinchunks:
print(f"Chunk:{chunk.text}")
print(f"Tokens:{chunk.token_count}")
问题3:Chonkie的性能如何,与其他分块库相比有何优势?
- 答:Chonkie在性能和轻量级方面具有显著优势:
- 大小:默认安装仅9.7MB,远小于竞争对手(80-171MB)。
- 使用Tiktoken作为默认分词器,速度比竞争对手快3-6倍。
- 这些优化使得Chonkie在处理大规模数据和实时应用时表现出色。
问题4:可以在不同的文本中多次运行一个Chunker吗?Chonkie 是线程安全的吗?
- 答:可以多次运行Chunker,无需重新初始化。Chonkie的分块器是线程安全的。