Skip to content
feynincPublic

About

πŸš€ The Fastest Chunker in the West πŸ‡ΊπŸ‡Έ Upto 1TB/s "semantic" chunking, quick and easy!

Resources

Contributing

Stars

361 stars

Watchers

3 watching

Forks

Latest commit

Β 

History

74 Commits

Folders and files

Repository files navigation

chunk

chunk

the fastest text chunking library β€” up to 1 TB/s throughput

crates.io docs.rs License


you know how every chunking library claims to be fast? yeah, we actually meant it.

chunk splits text at semantic boundaries (periods, newlines, the usual suspects) and does it stupid fast. we're talking "chunk the entire english wikipedia in 120ms" fast.

want to know how? read the blog post where we nerd out about SIMD instructions and lookup tables.

Note

chunk was previously known as memchunk. It still contains the chunk method, plus delimiter and pattern splitting.

Benchmark comparison

See benches/ for detailed benchmarks.

πŸ“¦ Installation

cargo add chunk

πŸš€ Usage

use chunk::chunk;

let text = b"Hello world. How are you? I'm fine.\nThanks for asking.";

// With defaults (4KB chunks, split at \n . ?)
let chunks: Vec<&[u8]> = chunk(text).collect();

// With custom size
let chunks: Vec<&[u8]> = chunk(text).size(1024).collect();

// With custom delimiters
let chunks: Vec<&[u8]> = chunk(text).delimiters(b"\n.?!").collect();

// With multi-byte pattern (e.g., metaspace ▁ for SentencePiece tokenizers)
let metaspace = "▁".as_bytes();
let chunks: Vec<&[u8]> = chunk(text).pattern(metaspace).prefix().collect();

// With consecutive pattern handling (split at START of runs, not middle)
let chunks: Vec<&[u8]> = chunk(b"word   next")
    .pattern(b" ")
    .consecutive()
    .collect();

// With forward fallback (search forward if no pattern in backward window)
let chunks: Vec<&[u8]> = chunk(text)
    .pattern(b" ")
    .forward_fallback()
    .collect();

πŸ“ Citation

If you use chunk in your research, please cite it as follows:

@software{chunk2025,
  author = {Minhas, Bhavnick},
  title = {chunk: The fastest text chunking library},
  year = {2025},
  publisher = {GitHub},
  howpublished = {\url{https://github.com/chonkie-inc/chunk}},
}

πŸ“„ License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

About

πŸš€ The Fastest Chunker in the West πŸ‡ΊπŸ‡Έ Upto 1TB/s "semantic" chunking, quick and easy!

Resources

Contributing

Stars

361 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages