CH

chonkie-ai/macha

Dataset

0

stars

19

commits

2

linked in READMEs

Jan 21, 2026

updated

README

📝 Macha: Markdown Chunking Assessment

GitHub READMEs for Evaluating Chunking Algorithms

Macha is a dataset of GitHub README files from popular open-source repositories, designed to evaluate how well chunking algorithms handle technical documentation with mixed content types.

Dataset Description

  • Documents: 445 GitHub README files
  • Questions: 1,812 question-answer pairs
  • Domain: Technical Documentation
  • Source: Top GitHub repositories by stars

Key Challenges

This dataset tests chunking algorithms on:

  • Markdown formatting (headers, lists, code blocks)
  • Mixed content (prose, code examples, tables)
  • Technical terminology and API references
  • Installation instructions and usage examples
  • Cross-references and links

Dataset Structure

Corpus Config

FieldDescription
rankRepository popularity rank
repoRepository name (owner/repo)
starsGitHub star count
textFull README content
token-countToken count
scoreQuality score

Questions Config

FieldDescription
questionQuestion about the README
answerAnswer to the question
chunk-must-containText passage that must be in the retrieved chunk
repoSource repository

Usage

from datasets import load_dataset

# Load corpus
corpus = load_dataset("chonkie-ai/macha", "corpus", split="train")

# Load questions
questions = load_dataset("chonkie-ai/macha", "questions", split="train")

Part of MTCB

Macha is part of the Massive Text Chunking Benchmark (MTCB), a comprehensive benchmark for evaluating RAG chunking strategies.

License

CC-BY-4.0

Contributors

bhavnicksm

19 commits

CH

chonkie-ai/macha

Dataset

0

stars

19

commits

2

linked in READMEs

Jan 21, 2026

updated

README

📝 Macha: Markdown Chunking Assessment

GitHub READMEs for Evaluating Chunking Algorithms

Macha is a dataset of GitHub README files from popular open-source repositories, designed to evaluate how well chunking algorithms handle technical documentation with mixed content types.

Dataset Description

  • Documents: 445 GitHub README files
  • Questions: 1,812 question-answer pairs
  • Domain: Technical Documentation
  • Source: Top GitHub repositories by stars

Key Challenges

This dataset tests chunking algorithms on:

  • Markdown formatting (headers, lists, code blocks)
  • Mixed content (prose, code examples, tables)
  • Technical terminology and API references
  • Installation instructions and usage examples
  • Cross-references and links

Dataset Structure

Corpus Config

FieldDescription
rankRepository popularity rank
repoRepository name (owner/repo)
starsGitHub star count
textFull README content
token-countToken count
scoreQuality score

Questions Config

FieldDescription
questionQuestion about the README
answerAnswer to the question
chunk-must-containText passage that must be in the retrieved chunk
repoSource repository

Usage

from datasets import load_dataset

# Load corpus
corpus = load_dataset("chonkie-ai/macha", "corpus", split="train")

# Load questions
questions = load_dataset("chonkie-ai/macha", "questions", split="train")

Part of MTCB

Macha is part of the Massive Text Chunking Benchmark (MTCB), a comprehensive benchmark for evaluating RAG chunking strategies.

License

CC-BY-4.0

Contributors

bhavnicksm

19 commits