chonkie

给 RAG 管道装上涡轮,让文档切块又快又准

Chonkie 是一个轻量级的 Python 文本分块(chunking)库,专为 RAG(检索增强生成)管道设计。它解决的是将长文档切分为适合嵌入和检索的文本块这一核心问题,避免因块过大导致检索不精准或块过小丢失上下文。Chonkie 提供多种分块策略,包括基于 Token 的固定长度分块、基于句子的语义分块、基于段落的分块以及递归字符分块等,并支持与 LangChain、LlamaIndex 等主流框架无缝集成。其设计强调性能与效率,底层采用 Rust 加速核心逻辑,在保证分块质量的同时显著提升处理速度。库的 API 简洁直观,易于上手,同时提供丰富的配置选项以满足不同场景需求。

开源 free 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 4766
维护状态 活跃
是否开源 是
定价模式 free

项目数据

分类搜索知识
开发团队feyninc
所属国家
定价模式free
价格说明开源库,MIT 许可证,完全免费,可自行部署使用。
访问状态
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai,chonkie,chunker,chunking-algorithm,llms,rag,retrieval-systems,semantic-chunker,similarity-search,splitting-algorithms,text-splitter
GitHub 星标★ 4766
30天Star增速
HF 下载量
上线时间2025-03-29 00:00:00
最近更新2026-09-22 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数1

使用教程

难度:入门 约 5 分钟 部署方式:库/依赖 5 步

环境要求

  • Python 环境(可用 pip 安装包)
  • 可选:已安装 uv 以获得更快的安装速度
  • 安装前确认目标环境是否允许安装全部可选依赖(生产环境不建议)

安装与启动步骤

  1. 1基础安装

    Chonkie 的最小安装方式,只装核心包。README 推荐的入门首选,适用于大多数分块场景。

    pip install chonkie
  2. 2用 uv 安装(可选)

    如果本机已安装 uv,可用同一条包名安装,速度更快。二选一即可,不必重复安装。

    uv pip install chonkie
  3. 3安装全部组件

    不想逐个挑选 chunker 时安装 all 元包,一次装齐所有可选依赖。README 明确不推荐用于生产环境。

    pip install "chonkie[all]"
  4. 4按需安装扩展

    README 给出的组合示例:安装 API、语义分块、代码分块依赖,并包含 catsu 多提供方嵌入支持。

    pip install "chonkie[api,semantic,code,catsu]"
  5. 5验证安装

    导入 Pipeline 类确认包已正确安装。能打印出 Chonkie ready 说明安装成功。

    python -c "from chonkie import Pipeline; print('Chonkie ready')"

如何确认成功

执行 python -c "from chonkie import Pipeline; print('Chonkie ready')",终端输出 Chonkie ready 即安装成功。

常见问题

Q:基础安装和 chonkie[all] 该选哪个?

A:先用 pip install chonkie 装核心;需要某个特定 chunker 时按官方文档只装对应扩展。chonkie[all] 一次装齐但体积大,README 明确不推荐在生产环境使用。

Q:用 pip 还是 uv?

A:两者等价,包名和扩展写法完全一致。uv 安装更快,若本机已有 uv 可用 uv pip install 替代 pip install。

Q:chonkie[api,semantic,code,catsu] 是什么?

A:README 给出的按需安装示例,一次性带上 API 依赖、语义分块、代码分块以及 catsu 多提供方嵌入支持。

Q:支持多语言文本分块吗?

A:支持。README 说明开箱即用支持 56 种语言,无需额外语言包配置。

Q:如何做高吞吐的异步处理?

A:使用 chonkie.Pipeline,并以异步方式调用其 arun 方法(await pipe.arun(...)),README 给出了 asyncio 的用法示例。

注意事项

  • Chonkie 遵循最小安装原则,建议只安装你实际使用的 chunker 依赖,避免体积膨胀。
  • 生产环境不要直接安装 chonkie[all]。
  • 更多 chunker 选择、Pipeline 构建方式和集成方式(LangChain、LlamaIndex 等)需查阅官方文档 https://docs.chonkie.ai。
  • README 中基础用法与 Pipeline 示例代码存在截断,完整可用示例请以官网文档为准。

核心亮点

  • 底层 Rust 实现,分块速度远超纯 Python 方案,处理大规模文档优势明显
  • 内置多种分块策略(Token/句子/段落/递归),适配不同文本类型和检索需求
  • API 设计简洁,与 LangChain、LlamaIndex 集成开箱即用,上手成本低

不足之处

  • 项目较新,版本迭代快,API 可能存在变动,需关注更新日志
  • 文档/社区待观察

适用场景

  • 构建企业级知识库问答系统,需要高效处理海量 PDF/Word 文档
  • 优化现有 RAG 管道,解决检索结果不精准或上下文丢失问题
  • 在资源受限环境(如边缘设备)中运行,需要轻量且快速的分块处理

替代项目

LangChain Text Splitters、LlamaIndex Node Parser、unstructured

项目介绍

chonkie 是搜索知识领域的开源项目,由 feyninc 开发,2025 年首次发布。

在全站 13,014 个收录项目中,它的 GitHub 星标数(4,766)位列前 9%,在搜索知识分类的 581 个项目里位列前 11%。

近 41 天,它的 GitHub 星标从 4,665 增加到 4,766,净增 101。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-22。开源库,MIT 许可证,完全免费,可自行部署使用。

它主要面向的使用场景是:构建企业级知识库问答系统,需要高效处理海量PDF/Word文档。同类可对比的替代方案包括 LangChain Text Splitters、LlamaIndex Node Parser、unstructured。

上一篇:53AIHub

下一篇:m_flow

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

The web data API to search, scrape, and interact at scale.

★ 183325 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

整个代码库画成一张图,找问题一眼定位

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 120493 2026-08-09
ragflow 开源

让大模型用上你的私有知识,搭建可靠的企业级RAG应用

RAGFlow is a leading open-source Retrieval-Augmented Generation (RAG) engine that fu···

★ 91170 2026-08-09