Skip to content

LightRAG

RAG & Retrieval

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

Track releases GitHub Website
Python Latest v1.5.0 · 23h ago Security brief →

Features

  • Multimodal document processing via RAG-Anything integration
  • Four selectable text chunking strategies (Fix, Recursive, Vector, Paragraph)
  • Role‑specific LLM configuration with independent settings for EXTRACT, QUERY, KEYWORDS, and VLM
  • Integrated OpenSearch as a unified storage backend
  • Setup wizard for local deployment of embedding, reranking, and storage backends via Docker

Recent releases

View all 13 releases →
Config change
v1.5.0 Breaking risk
Breaking upgrade

Multimodal support + native DOCX parsing

Open
Config change
v1.5.0rc3 Breaking risk

Multimodal, DOCX, chunking, roles, Bedrock

Open
Config change
v1.5.0rc2 Breaking risk
Breaking upgrade

Multimodal, DOCX parser, chunking, roles, Bedrock

Open
v1.4.16 Breaking risk
Breaking changes
  • Requires OpenSearch ≥ 3.3.0 due to version‑aware sort tiebreaker for PIT search
Notable features
  • Explicit voyageai embed support
  • Task‑aware embedding support
Full changelog

What's Breaking

It's a breaking change for existing deployments on OpenSearch < 3.3.0. OpenSearch: Use version-aware sort tiebreaker for PIT search by @LantaoJin in https://github.com/HKUDS/LightRAG/pull/2991

What's New

  • 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

What's Changed

  • 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
  • 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
  • Add Podman-compatible compose file by @tears710 in https://github.com/HKUDS/LightRAG/pull/2983
  • fix: remove stream parameter from .parse() call when response_format is present by @PaulTitto in https://github.com/HKUDS/LightRAG/pull/2965
  • 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

New Contributors

  • @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

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

View release on GitHub
v1.5.0rc1 Breaking risk
Breaking changes
  • ENTITY_TYPES environment variable is deprecated; use ENTITY_TYPE_PROMPT_FILE instead
Notable features
  • VoyageAI embedding support
  • Task-aware embedding support
  • Role-specific LLM configuration
Full changelog

Breaking Changed

  • Env var ENTITY_TYPES is deprecated, use ENTITY_TYPE_PROMPT_FILE instead

What's New

  • feat: 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
  • feat: integrate structured extraction and multimodal processing pipeline by @MrGidea in
  • feat: apply entity extraction best practice and add full-service comparisons by @MrGidea in https://github.com/HKUDS/LightRAG/pull/2830
  • feat: enhance entity extraction stability dev by @yunzhongxiaxi in https://github.com/HKUDS/LightRAG/pull/2864
  • 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
  • feat: add role-specific LLM configuration by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2976
  • feat(rerank): add independent concurrency and timeout configuration by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2981
  • Add Podman-compatible compose file by @tears710 in https://github.com/HKUDS/LightRAG/pull/2983

What's Changed

  • ♻️ 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
    https://github.com/HKUDS/LightRAG/pull/2914
  • 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(bedrock): support default and custom endpoints by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2958
  • refactor(gemini): improve default endpoint handling and sdk integration by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2957
  • 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
    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
  • 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
  • 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

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

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

View release 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.

About

Stars
36,118
Forks
5,106
Languages
Python TypeScript Shell
View on GitHub Homepage

Install & Platforms

Install via
pip

Community & Support

Discord

Tracked by

1 person tracking

People also track

kanboard
1 tracking
pocket-id
1 tracking
Kyoo
1 tracking
Superset
1 tracking
Claude Squad
1 tracking
CodexMonitor
1 tracking

Similar tools

ragflow
WeKnora
besslframework-stack/project-tessera
papra
lyonzin/knowledge-rag

Beta — feedback welcome: [email protected]