Download Latest Version v1.5.7 source code.zip (9.7 MB)
Email in envelope

Get an email when there's a new version of LightRAG

Home / v1.5.5
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2026-07-31 23.3 kB
v1.5.5 source code.tar.gz 2026-07-31 7.9 MB
v1.5.5 source code.zip 2026-07-31 8.4 MB
Totals: 3 Items   16.3 MB 0

🎉 AddSmart Heading Recognition Feature For Word Document

Starting from v1.5.5, LightRAG's built-in DOCX parser introduces the Smart Heading feature -- enabling better section-based chunking even for poorly formatted DOCX documents.

Many DOCX documents have visually clear section structures but lack properly configured Word outline levels, or retain incorrect heading styles from editing, copying, and concatenation processes. In the past, these issues could cause section titles to be treated as body text, or regular text to be misidentified as headings, resulting in chunking boundaries that deviate from the document's true semantic sections. For P chunking strategies that rely on heading structures, this creates fragmented context or mixed content from different sections, affecting subsequent indexing and retrieval.

Smart Heading targets such poorly formatted but semantically clear documents, restoring their true heading structures as much as possible:

  1. Recover Missing Section Titles: Identify content that visually appears as titles but lacks properly configured outline levels, reducing loss of section structures.
  2. Reduce False Positives of Body Text as Headings: Restore regular body text, complete clauses, captions, dates, and version notes that incorrectly carry heading styles back to body text, avoiding meaningless chunking boundaries.
  3. Improve Inconsistent Heading Hierarchies: Reduce issues such as inconsistent sibling heading levels, inverted parent-child hierarchies, and skipped levels, making section structures more coherent.
  4. Distinguish Multiple Contents in Merged Documents: Identify main titles and document boundaries of each piece of content, preventing section level interference between different documents.
  5. Reduce Noise from Long Tables of Contents: Compress excessively long table of contents, minimizing the interference of duplicate information on indexing and retrieval.

By providing more reliable section structures for subsequent chunking, Smart Heading helps maintain semantic associations between titles and their corresponding body text, making chunking results align better with the document's original content organization.

Smart Heading is an optional capability of the Native DOCX parser and requires activation to take effect. For enabling and configuration instructions, please refer to: docs/FileProcessingPipeline / 中文版.

What's New

What's Changed

New Contributors

Full Changelog: https://github.com/HKUDS/LightRAG/compare/v1.5.4...v1.5.5

Source: README.md, updated 2026-07-31