LightRAG

v1.5.0rc2 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 13d RAG & Retrieval

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

genai llm gpt-4 graphrag knowledge-graph large-language-models

+1 more

retrieval-augmented-generation

Affected surfaces

breaking_upgrade

ReleasePort's take

Moderate signal

editorial:auto 13d

LightRAG v1.5.0rc2 absorbs RagAnything's multimodal capabilities (images, tables, formulas) as native features and adds AWS Bedrock model support. ENTITY_TYPES environment variable is deprecated; migrate configuration to ENTITY_TYPE_PROMPT_FILE before upgrading.

Why it matters: ENTITY_TYPES is deprecated; replace with ENTITY_TYPE_PROMPT_FILE before upgrade. RagAnything consolidation ends its updates. Plan dev testing of multimodal document processing (images, tables, formulas) and AWS Bedrock models before upgrading.

Summary

AI summary

Broad release touches What's Broken, deps, Major Improvements, and pipeline. Breaking: Deprecated the ENTITY_TYPES environment variable; replace it with ENTITY_TYPE_PROMPT_FILE before upgrading

Changes in this release

Type	Severity	Summary	CVE
Security	Medium	Escape wildcard metacharacters in OpenSearch search_labels to prevent DoS (CWE-89). Escape wildcard metacharacters in OpenSearch search_labels to prevent DoS (CWE-89). Source: granite4.1:8b-q6_K@2026-05-21 Confidence: low	—
Breaking	Medium	ENTITY_TYPES environment variable deprecated; replace with ENTITY_TYPE_PROMPT_FILE before upgrading. ENTITY_TYPES environment variable deprecated; replace with ENTITY_TYPE_PROMPT_FILE before upgrading. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: low	—
Feature
Feature	Medium	LightRAG now supports multimodal document processing with images, tables, and formulas. LightRAG now supports multimodal document processing with images, tables, and formulas. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	All RagAnything’s multimodal capabilities merged into LightRAG; RagAnything no longer receives updates. All RagAnything’s multimodal capabilities merged into LightRAG; RagAnything no longer receives updates. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Fully upgraded document processing pipeline with MinerU and Docling support. Fully upgraded document processing pipeline with MinerU and Docling support. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	LightRAG introduces Native Parsing for high-quality DOCX extraction, including auto-numbering and multimodal content. LightRAG introduces Native Parsing for high-quality DOCX extraction, including auto-numbering and multimodal content. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Four selectable text chunking strategies: Fix, Recursive, Vector, and Paragraph via environment variables. Four selectable text chunking strategies: Fix, Recursive, Vector, and Paragraph via environment variables. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	File processing pipeline allows selecting parsing engine and chunking strategy per file or extension. File processing pipeline allows selecting parsing engine and chunking strategy per file or extension. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Enable task-aware embedding support for asymmetric models like voyage-3 and jina-embeddings-v3. Enable task-aware embedding support for asymmetric models like voyage-3 and jina-embeddings-v3. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Optional JSON-formatted LLM output enhances entity and relation extraction stability. Optional JSON-formatted LLM output enhances entity and relation extraction stability. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Improved entity/relation extraction reliability with LLM JSON-structured output; toggle via ENTITY_EXTRACTION_USE_JSON. Improved entity/relation extraction reliability with LLM JSON-structured output; toggle via ENTITY_EXTRACTION_USE_JSON. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Introduce ENTITY_TYPE_PROMPT_FILE for enhanced LLM-driven entity type recognition. Introduce ENTITY_TYPE_PROMPT_FILE for enhanced LLM-driven entity type recognition. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Fully support Amazon and Anthropic models on AWS Bedrock API. Fully support Amazon and Anthropic models on AWS Bedrock API. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Feature	Medium	Implemented role-specific LLM configuration with four roles: EXTRACT, QUERY, KEYWORDS, VLM. Implemented role-specific LLM configuration with four roles: EXTRACT, QUERY, KEYWORDS, VLM. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Dependency	Medium	Bumped react-router-dom from 7.14.0 to 7.14.1 in LightRAG web UI. Bumped react-router-dom from 7.14.0 to 7.14.1 in LightRAG web UI. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: low	—
Performance	Medium	Use binary parameter for vector similarity queries in PostgreSQL storage. Use binary parameter for vector similarity queries in PostgreSQL storage. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Bugfix	Medium	Handle OpenAI length finish reason fallback in LLM processing. Handle OpenAI length finish reason fallback in LLM processing. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: high	—
Refactor	Medium	Reorganized document status filtering in documentManager. Reorganized document status filtering in documentManager. Source: granite4.1:8b-q6_K@2026-05-21 Confidence: low	—

Full changelog

Major Improvements

LightRAG now supports multimodal document processing and can fully leverage images, tables, and formulas within documents to answer queries. All RagAnything’s multimodal processing capabilities are merged into LightRAG; ( RagAnything will no longer receive core feature updates or maintenance going forward)
Fully upgraded the document processing pipeline, with support for using MinerU and Docling to parse and extract file content, seamlessly integrating with multimodal content analysis and entity-relationship extraction.
LightRAG now introduces Native Parsing, enabling high-quality content extraction from DOCX documents. It supports accurate reconstruction of Word auto-numbering, as well as extraction of images, tables, and formulas, providing seamless integration with multimodal content analysis and entity-relationship extraction. Expanded format support for the Native Parser is coming soon.
Introduced four selectable text chunking strategies: Fix, Recursive, Vector, and Paragraph. The parameters for each chunking strategy can be configured through environment variables.
The file processing pipeline supports selecting the content parsing engine and text chunking strategy either based on file extensions or on a per-file basis. For detailed usage instructions, refer to FileProcessingPipeline.md.
Enable task-aware embedding support for asymmetric models, including voyage-3, text-embedding-004, embed-multilingual-v3.0, and jina-embeddings-v3.
Add optional JSON-formatted LLM output to enhance stability in the entity and relation extraction pipeline.
Improved entity/relation extraction reliability by introducing LLM JSON-structured output; set ENTITY_EXTRACTION_USE_JSON=true to enable it.
Introduce ENTITY_TYPE_PROMPT_FILE to empower users with enhanced guidance for LLM-driven entity type recognition and extraction.
Fully support Amazon and Anthropic models on AWS Bedrock API.
Implemented role-specific LLM configuration support, introducing four distinct roles: EXTRACT, QUERY, KEYWORDS, and VLM, each with independent LLM settings. It is recommended to configure the KEYWORDS role with a small-parameter, non-reasoning, high-speed model to optimize query latency; the EXTRACT role with a medium-parameter, non-reasoning model to balance accuracy and throughput; and the QUERY role with a large-parameter reasoning model to enhance query quality. For detailed usage instructions, refer to RoleSpecificLLMConfiguration.md.

What's Broken

The ENTITY_TYPES environment variable has been deprecated; Please replace it with ENTITY_TYPE_PROMPT_FILE before launching this new version.
For OpenSearch versions prior to 3.3.0, upgrade OpenSearch before upgrading LightRAG (see https://github.com/HKUDS/LightRAG/pull/2991).

What's Changed

feat: integrate structured extraction and multimodal role-based pipelineFeat/multimodal pipeline by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2830
♻️ refactor(documentManager): reorganize document status filtering by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2851
Remove config.ini from compose samples by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2906
fix: handle OpenAI length finish reason fallback by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2913
feat: apply entity extraction best practice and add full-service comparisons by @MrGidea in https://github.com/HKUDS/LightRAG/pull/2914
Feature/enhance entity extraction stability dev by @yunzhongxiaxi in https://github.com/HKUDS/LightRAG/pull/2864
feat(extraction): configurable per-response entity/relation limits by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2950
♻️ refactor(llm): unify keyword extraction across providers by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2953
♻️ refactor(llm): unify structured output control via response_format by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2956
refactor(gemini): improve default endpoint handling and sdk integration by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2957
refactor(bedrock): support default and custom endpoints by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2958
refactor(setup): use sentinel endpoints for Gemini and Bedrock defaults by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2959
perf(postgres): use binary parameter for vector similarity queries by @wkpark in https://github.com/HKUDS/LightRAG/pull/2949
feat(prompt): externalize entity type extraction profiles by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2964
feat(bedrock): rename aws_bedrock to bedrock and add BindingOptions support by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2966
chore(deps): bump react-router-dom from 7.14.0 to 7.14.1 in /lightrag_webui in the react group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2967
chore(deps-dev): bump the build-tools group in /lightrag_webui with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2968
chore(deps): bump the frontend-minor-patch group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2969
Fix role LLM max async fallback by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2973
fix(llm): tighten client and stream cleanup across LLM bindings by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2974
chore(deps): bump lucide-react from 0.577.0 to 1.6.0 in /lightrag_webui by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2970
docs: add role-specific LLM configuration guide by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2976
refactor: unify role LLM config via ROLES registry + queue observability by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2978
feat(status): role-based LLM observability and storage workspace info by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2980
feat(rerank): add independent concurrency and timeout configuration by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2981
Fix LLM cache role identity isolation by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2982
Add role LLM provider options logging and change role provider options to start from empty not default by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2984
Add Podman-compatible compose file by @tears710 in https://github.com/HKUDS/LightRAG/pull/2983
Fix bedrock/gemini host leak from env.example on make server/storage by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2985
fix: remove stream parameter from .parse() call when response_format is present by @PaulTitto in https://github.com/HKUDS/LightRAG/pull/2965
Explicit voyageai embed support by @laszukdawid in https://github.com/HKUDS/LightRAG/pull/2484
feat: Add task-aware embedding support by @StoreksFeed in https://github.com/HKUDS/LightRAG/pull/2560
Improve DOCX parsing idempotency by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2987
OpenSearch: Use version-aware sort tiebreaker for PIT search by @LantaoJin in https://github.com/HKUDS/LightRAG/pull/2991
Refactor DOCX archive handling by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2994
refactor: remove embedded docling and raganything fallbacks by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2997
Refactor file parser routing by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2998
Deduplicate documents by filename by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3000
Fix parsed document artifact isolation by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3005
Fix parser-hinted filename dedup by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3006
feat(native): align docx parser with mineru LIGHTRAG output (.blocks.jsonl) by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3008
♻️ refactor(lightrag): split monolithic lightrag.py into focused modules by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3012
feat(parser_routing): per-file process options and canonical basename by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3013
feat(api): pipeline reentrancy guards and idempotent multimodal analyze by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3014
fix(pipeline): preserve process_options in doc_status metadata across transitions by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3017
feat(pipeline): resume already-extracted documents under current process_options by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3015
refactor(pipeline): normalize parser / extraction metadata field names by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3021
♻️ refactor(pipeline): unify F chunking for raw and lightrag formats by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3023
♻️ refactor(docx): move native parser to lightrag/native_parser/docx by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3030
chore(deps): bump react-router-dom from 7.14.1 to 7.14.2 in /lightrag_webui in the react group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3001
chore(deps): bump the ui-components group in /lightrag_webui with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3002
chore(deps): bump axios from 1.15.1 to 1.15.2 in /lightrag_webui in the frontend-minor-patch group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3004
chore(deps-dev): bump the build-tools group across 1 directory with 5 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3003
Replace status tooltip with details modal by @g2424303264-code in https://github.com/HKUDS/LightRAG/pull/3025
fix(webui): resolve react-hooks lint errors after eslint-plugin upgrade by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3036
chore(deps): bump lucide-react from 1.9.0 to 1.14.0 in /lightrag_webui in the ui-components group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3032
chore(deps): bump sigma from 3.0.2 to 3.0.3 in /lightrag_webui in the graph-viz group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3033
chore(deps-dev): bump typescript-eslint from 8.59.1 to 8.59.2 in /lightrag_webui in the build-tools group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3034
chore(deps): bump i18next from 25.10.10 to 26.0.3 in /lightrag_webui by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3035
Add prefix path to API and WebUI by @shahrin014 in https://github.com/HKUDS/LightRAG/pull/3007
feat(webui): inject path prefix at runtime — one build serves all sites by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3039
refactor(pipeline): split apipeline_process_enqueue_documents into helpers by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3041
feat(openai): inject X-DashScope-Workspace header from DASHSCOPE_WORKSPACE_ID env by @getsov75-maker in https://github.com/HKUDS/LightRAG/pull/3042
Update README by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3047
Add paragraph semantic chunking strategy by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3044
feat(chunker): add R/V chunkers and chunk_options snapshot mechanism by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3046
Add offline sample retrieval check for RAGAS evaluation by @FU-max-boop in https://github.com/HKUDS/LightRAG/pull/3038
fix(chunker): CJK punctuation support and chunk_token_size enforcement by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3050
feat(chunker): split oversized tables on row boundaries before char fallback by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3051
chore(deps): bump sigstore/cosign-installer from 4.1.1 to 4.1.2 in the github-actions group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3053
fix(chunker): preserve HTML table row group wrappers by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3055
fix(PGGraphStorage): edge properties lost on upsert with Apache AGE by @oleksandr-kushnir in https://github.com/HKUDS/LightRAG/pull/3052
feat(multimodal): backfill surrounding context on native sidecars by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3057
docs: fix typo 'Papper' to 'Paper' in README by @viraj1995 in https://github.com/HKUDS/LightRAG/pull/3058
feat(llm/vlm): unify image_inputs across bindings + VLM cache + master switch by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3063
chore(deps): update google-genai requirement from <2.0.0,>=1.0.0 to >=1.0.0,<3.0.0 by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3062
chore(deps): update pymilvus requirement from <3.0.0,>=2.6.2 to >=2.6.2,<4.0.0 by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3061
Refactor multimodal: status semantics, nested chunk schema, per-chunk entity injection by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3064
style: update EmptyCard and DocumentManager for improved layout by @JackLuguibin in https://github.com/HKUDS/LightRAG/pull/3060
fix(opensearch): escape wildcard metacharacters in search_labels to prevent DoS (CWE-89) by @sebastiondev in https://github.com/HKUDS/LightRAG/pull/3026
feat(docx): doc_title from first heading, table_header in sidecar by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3065
feat(multimodal): defer sidecar surrounding to analyze entry; env-tunable budgets by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3066
✨ feat(sidecar): shorten item IDs by stripping doc- prefix by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3067
feat(multimodal): strip parser-internal markup from sidecar surrounding by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3068
✨ feat(extract): enforce MAX_EXTRACT_INPUT_TOKENS for analyze & gleaning by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3073
chore(deps): bump the react group in /lightrag_webui with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3069
chore(deps-dev): bump the build-tools group in /lightrag_webui with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3070
chore(deps): bump the frontend-minor-patch group across 1 directory with 5 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3071
chore(deps): bump react-i18next from 16.6.6 to 17.0.3 in /lightrag_webui by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/3072
refactor(multimodal): inline bracket-label format for mm chunks by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3074
fix: extract Docling async markdown result by @he-yufeng in https://github.com/HKUDS/LightRAG/pull/3031
feat(parse_mineru): unified sidecar writer + MinerU raw bundle cache by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3075
feat(native_parser/docx): route through unified SidecarWriter by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3077
feat: dedupe cross-filename uploads via merged_text normalization by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3078
feat(mineru): split-by-heading block merging with markdown titles by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3079
test: harden hermetic env fixture and fix MinerU put() fake by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3080
feat(mineru): emit page-level positions from page_idx by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3081
feat(docling): route parse_docling through sidecar bundle pipeline by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3085
fix: guard against IndexError on empty LLM choices list by @qizwiz in https://github.com/HKUDS/LightRAG/pull/3086
refactor(parser): rename adapters to ir_builder and consolidate parser packages by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3087
feat(parser_cli): unified debug CLI for native / mineru / docling by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3088
Tokenizer.encode: gracefully handle disallowed special tokens in content by @RooseveltAdvisors in https://github.com/HKUDS/LightRAG/pull/3082
Improve MinerU parsing provenance and upload handling by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3089
fix(parsers): drop empty-bodied tables to prevent analyze worker hard-failure by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3090
feat(doc-status): add per-stage start time and parse-skipped flag by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3091
feat(mineru): invalidate raw bundle cache on parser option changes by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3092
refactor(full-docs): unify path handling and slim chunk_options snapshot by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3093
refactor(pg): align PG storage fields with JSON storage for parity by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3094
feat(redis): add basename and content_hash lookups for doc status by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3098
refactor(mongo): align doc-status storage with JSON storage for parity by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3099
feat(opensearch): add basename and content_hash lookups for doc status by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3100
feat(pipeline-status): probe + throttled refresh for prompt scan/upload feedback by @danielaskdd https://github.com/HKUDS/LightRAG/pull/3101
feat(chunker): give P strategy a dedicated default chunk_token_size by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/3102

New Contributors

@yunzhongxiaxi made their first contribution in https://github.com/HKUDS/LightRAG/pull/2864
@tears710 made their first contribution in https://github.com/HKUDS/LightRAG/pull/2983
@PaulTitto made their first contribution in https://github.com/HKUDS/LightRAG/pull/2965
@laszukdawid made their first contribution in https://github.com/HKUDS/LightRAG/pull/2484
@g2424303264-code made their first contribution in https://github.com/HKUDS/LightRAG/pull/3025
@shahrin014 made their first contribution in https://github.com/HKUDS/LightRAG/pull/3007
@getsov75-maker made their first contribution in https://github.com/HKUDS/LightRAG/pull/3042
@FU-max-boop made their first contribution in https://github.com/HKUDS/LightRAG/pull/3038
@oleksandr-kushnir made their first contribution in https://github.com/HKUDS/LightRAG/pull/3052
@viraj1995 made their first contribution in https://github.com/HKUDS/LightRAG/pull/3058
@JackLuguibin made their first contribution in https://github.com/HKUDS/LightRAG/pull/3060
@qizwiz made their first contribution in https://github.com/HKUDS/LightRAG/pull/3086

Full Changelog: https://github.com/HKUDS/LightRAG/compare/v1.4.15...v1.5.0rc2

Breaking Changes

Deprecated the `ENTITY_TYPES` environment variable; replace it with `ENTITY_TYPE_PROMPT_FILE` before upgrading.
Requires OpenSearch version 3.3.0 or later; upgrade OpenSearch prior to LightRAG upgrade.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track LightRAG

Get notified when new releases ship.

About LightRAG

[EMNLP2025] "LightRAG: Simple and Fast Retrieval-Augmented Generation"

All releases →

Related context

Related tools

Earlier breaking changes

v1.5.0rc3 Removes deprecated `QueryParam.model_func` field from lightrag/base.py.
v1.5.0rc3 Deprecates the `ENTITY_TYPES` environment variable; replace with ENTITY_TYPE_PROMPT_FILE.