Skip to content

Chonkie

Biblioteca de Python pequeña y rápida que divide texto en fragmentos para RAG, con once estrategias, desde tamaño fijo hasta guiadas por un LLM.

Reseña de Sheela · Actualizado

Ver en GitHub Código abierto

Nuestra nota

3.7/5

Una biblioteca de chunking cuidada y en plena reescritura: la v1.7 funciona hoy, pero casi todo lo que la distingue está previsto que desaparezca en la v2.

¿Qué es Chonkie?

Chonkie hace una sola tarea en un pipeline de generación aumentada por recuperación (RAG): corta texto ya extraído en fragmentos antes de generar sus embeddings y almacenarlos. La versión 1.7.0 incluye once chunkers, desde la división fija por tokens y por frases, pasando por el chunking recursivo, semántico, late, de código, de tablas y neuronal, hasta un chunker guiado por LLM llamado "Slumber", además de una Pipeline API y un servidor REST autoalojado.

En agosto de 2026 los mantenedores anunciaron que la 1.7 será la última versión 1.x. Chonkie v2 es una reescritura como un pequeño núcleo en Rust con bindings para Python y JavaScript que conserva los chunkers de tokens, frases, recursivo y de código y elimina las integraciones con bases de datos vectoriales y otras piezas de fontanería; mientras tanto, la rama principal está cerrada a pull requests. El servicio alojado Chonkie Cloud ya no resuelve.

Tiene licencia MIT y lo desarrolla Chonkie, Inc., una empresa de Y Combinator que ahora opera como Feyn y vende entrenamiento de modelos a medida; chonkie.ai redirige a usefeyn.com y el repositorio está en la organización feyninc.

¿Merece la pena Chonkie?

Chonkie es una respuesta bien hecha a una pregunta que importa menos de lo que se cree, y sus propios mantenedores ya lo reconocen. En el anuncio de la v2, de agosto de 2026, cuentan que, en cientos de ejecuciones de su benchmark MTCB, los chunkers semántico, neuronal y Slumber eran o bien mucho peores que el recursivo o bien quedaban a entre un 2 y un 3 por ciento de él. Coincide con trabajos externos: un estudio de Vectara de 2024 concluyó que el cómputo extra del chunking semántico no estaba justificado, y un estudio de agosto de 2026 sobre ocho estrategias halló que la ganadora cambia según el modelo de embeddings, el conjunto de datos y la métrica.

La biblioteca es popular. El anuncio cita 1,3 millones de descargas al mes, y el repositorio tiene unas 4.800 estrellas. La instalación base es pequeña (el README habla de un wheel de 505KB) y el chunker recursivo con su receta para Markdown es una opción por defecto sensata. Las cifras de velocidad, como un chunker SIMD a "100+ GB/s", son benchmarks del propio proyecto.

El problema es el momento. La v1.7.0 salió el 7 de julio de 2026 y es la última versión 1.x; las correcciones van a la v2, la rama principal está cerrada a pull requests y el último commit en main fue el 26 de agosto de 2026. La v2 elimina las integraciones (los "handshakes" con Qdrant, pgvector y otros), los chefs y los chunkers de nube obsoletos, y promete una guía de migración de 1.x a 2.0. Entre los fallos abiertos hay un cierre inesperado de CodeChunker con tree-sitter-language-pack 1.16.1 y tokenizadores por nombre que ignoran HF_HUB_OFFLINE y se bloquean esperando a la red.

Un equipo que lo adopte ahora compra una dependencia que tendrá que migrar en cuestión de meses, a una API que todavía no puede leer. Es una apuesta razonable para quien solo necesita chunking recursivo o de código, que la v2 conserva. Es mala para quien elija Chonkie por su menú de estrategias o sus conectores con almacenes vectoriales, algo que los splitters de LlamaIndex y LangChain ya cubren con horizontes de soporte más largos.

Dónde se gana su sitio

  • Una ingeniera de plataforma que ingiere cada noche 200.000 páginas Markdown de un centro de ayuda

    Dividir documentos de forma coherente antes de los embeddings sin cargar un framework RAG entero

    pip install chonkie y usa RecursiveChunker con la receta markdown; la instalación pequeña encaja en un trabajo por lotes serverless. Fija la 1.7.0 y planifica la migración a la v2, porque no llegarán más correcciones 1.x.

  • Un ingeniero de ML en una start-up de tecnología legal que evalúa la calidad de la recuperación

    Probar si el chunking semántico o late supera al recursivo en sus contratos

    Cambia de chunker detrás de una misma API y mide el recall con un conjunto de preguntas reservado. Merece un día, no un trimestre: los mantenedores vieron que los chunkers sofisticados quedaban a entre un 2 y un 3 por ciento del recursivo, y la v2 los elimina.

  • Una responsable de datos que elige la pila de ingesta para un producto a dos años

    Elegir dependencias que sigan teniendo soporte el año que viene

    Trata Chonkie solo como una primitiva de chunking. Sus handshakes con almacenes vectoriales desaparecen en la v2, así que conecta Qdrant o pgvector directamente, o usa LlamaIndex si quieres que otros mantengan los conectores.

Antes de decidirte

Puesta en marcha
pip install chonkie con Python 3.10 o posterior; los chunkers más pesados necesitan extras como chonkie[semantic] o chonkie[code]. El primer documento fragmentado lleva minutos en la CPU de un portátil.
Integraciones
La v1.7 trae handshakes para Chroma, Elasticsearch, MongoDB, pgvector, Pinecone, Qdrant y otros, un chef de Mistral OCR y un servidor REST; la v2 eliminará los handshakes y los chefs.
Datos y privacidad
Se ejecuta en local y no se ha encontrado telemetría en el código. Los tokenizadores por nombre se descargan del Hugging Face Hub, y una incidencia abierta indica que esto ignora HF_HUB_OFFLINE. El servidor REST guarda los pipelines en un SQLite local.
Coste a escala
Gratis bajo MIT; el chunking recursivo y por tokens funciona en CPU. Los costes vienen de las llamadas a embeddings o a LLM detrás del chunking semántico, late o Slumber. El antiguo Chonkie Cloud ya no resuelve y Feyn no vende ningún producto de chunking.
Límites
49 incidencias y pull requests abiertas, main congelada durante la reescritura v2; no analiza PDF ni archivos de Office, así que Docling o algo similar tiene que ir delante.

Lo bueno

  • Instalación base pequeña con extras opcionales
  • Chunkers recursivo y de código que siguen en la v2
  • Los mantenedores publican resultados de benchmarks con franqueza
  • Licencia MIT permisiva

Lo malo

  • La v1.7 es la última versión 1.x; main está congelada
  • La v2 elimina los chunkers semántico, neuronal y Slumber y todas las integraciones
  • La empresa se ha volcado en el entrenamiento de modelos a medida

Ideal para

Equipos que necesitan un paso ligero de chunking recursivo o de código y pueden asumir pronto una migración a la v2.

Alternativas a Chonkie

Chonkie: preguntas frecuentes

¿Merece la pena Chonkie?
Una biblioteca de chunking cuidada y en plena reescritura: la v1.7 funciona hoy, pero casi todo lo que la distingue está previsto que desaparezca en la v2. Le damos un 3.7 sobre 5.
¿Cuánto cuesta Chonkie?
Gratuito y de código abierto bajo la licencia MIT.
¿Qué inconvenientes tiene Chonkie?
La v1.7 es la última versión 1.x; main está congelada; la v2 elimina los chunkers semántico, neuronal y Slumber y todas las integraciones; la empresa se ha volcado en el entrenamiento de modelos a medida.
¿Para quién es Chonkie?
Equipos que necesitan un paso ligero de chunking recursivo o de código y pueden asumir pronto una migración a la v2.
¿Cuánto cuesta Chonkie para un equipo o en producción?
Gratis bajo MIT; el chunking recursivo y por tokens funciona en CPU. Los costes vienen de las llamadas a embeddings o a LLM detrás del chunking semántico, late o Slumber. El antiguo Chonkie Cloud ya no resuelve y Feyn no vende ningún producto de chunking.
¿Es Chonkie seguro para los datos de la empresa?
Se ejecuta en local y no se ha encontrado telemetría en el código. Los tokenizadores por nombre se descargan del Hugging Face Hub, y una incidencia abierta indica que esto ignora HF_HUB_OFFLINE. El servidor REST guarda los pipelines en un SQLite local.
¿Cuáles son las mejores alternativas a Chonkie?
Las alternativas más cercanas que hemos analizado son LlamaIndex, LangChain y Docling.

Respuestas comprobadas el 26 oct 2026.