Skip to content

Release history

LightRAG releases

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

Back to tool Latest release

All releases

13 shown

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
v1.4.15 Mixed
Security fixes
  • Parameterized Cypher write queries to prevent SQL injection
Notable features
  • Added embedding support for providers without base64 encoding (e.g., Yandex Cloud)
  • Binary parameter optimization for PostgreSQL vector similarity queries
  • Auto-resolve PostgreSQL vector settings
Full changelog

What's New

  • ci: sign GHCR docker images with cosign by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2940
  • feat(embeddings): added embedding support for providers that don't support base64 encoding (e.g. Yandex Cloud) by @KirillCh143 in https://github.com/HKUDS/LightRAG/pull/2935
  • perf(postgres): use binary parameter for vector similarity queries @wkpark in https://github.com/HKUDS/LightRAG/pull/2949

What's Changed

  • fix(postgres): remove duplicate SET clause in upsert_edge Cypher query by @sjhddh in https://github.com/HKUDS/LightRAG/pull/2929
  • feat(postgres): auto-resolve postgres vector setting by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2933
  • fix(postgres): parameterize Cypher write queries to prevent injection by @sjhddh in https://github.com/HKUDS/LightRAG/pull/2931
  • fix(graph): return 0 for missing node/edge degree instead of None by @sjhddh in https://github.com/HKUDS/LightRAG/pull/2930
  • fix(setup): preserve storage images on compose rewrites by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2934
  • Fix local setup device prompt defaults and ordering by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2939
  • chore(deps): bump the react group in /lightrag_webui with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2945
  • chore(deps-dev): bump the build-tools group in /lightrag_webui with 4 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2946
  • chore(deps): bump axios from 1.14.0 to 1.15.0 in /lightrag_webui in the frontend-minor-patch group by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2947
  • chore(deps-dev): bump vite from 7.3.2 to 8.0.0 in /lightrag_webui by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2948
  • fix(webui): graph settings not persisting when popover closes by @radioflyer28 in https://github.com/HKUDS/LightRAG/pull/2954

New Contributors

  • @KirillCh143 made their first contribution in https://github.com/HKUDS/LightRAG/pull/2935
  • @radioflyer28 made their first contribution in https://github.com/HKUDS/LightRAG/pull/2954
  • @wkpark make heir first contribution in https://github.com/HKUDS/LightRAG/pull/2949

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

View release on GitHub
v1.4.14 Security relevant
Security fixes
  • JWT algorithm confusion attack prevention (GHSA-8ffj-4hx4-9pgf)
Notable features
  • Atlas Local Docker support for Mongo vector storage
  • Batch graph operations in ainsert_custom_kg for large-scale imports
  • AG2 multi-agent demo with LightRAG retrieval
View release on GitHub
v1.4.13 Security relevant
Security fixes
  • Sanitize entity_type in Memgraph upsert to prevent Cypher injection (CWE-89)
Notable features
  • PostgreSQL performance timing instrumentation
  • Document status filtering improvements
View release on GitHub
v1.4.11 New feature
Notable features
  • OpenSearch unified storage backend
  • Interactive setup wizard
  • Local Docker Compose deployment
View release on GitHub
v1.4.11rc2 Mixed
Notable features
  • Makefile for modular deployment
  • Query embedding pre-compute optimization
  • Qdrant bounded batching for large payloads
Full changelog

What's New

  • Add Makefile for quick deployment by @mlimarenko in https://github.com/HKUDS/LightRAG/pull/2548
  • Refactor(Makefile): split monolithic wizard into modular env-base/storage/server targets by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2763

For detail information about setup wizard, pls refer to: InteractiveSetup.md

What's Changed

  • Fix Qdrant large upsert payload failures with bounded batching by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2740
  • perf: use deque for BFS queue in get_knowledge_subgraph() by @giulio-leone in https://github.com/HKUDS/LightRAG/pull/2725
  • perf: batch pre-compute query embeddings to eliminate sequential API round-trips by @errajibadr in https://github.com/HKUDS/LightRAG/pull/2729
  • fix: reduce FaissVectorDBStorage meta.json file size by excluding vectors by @Br1an67 in https://github.com/HKUDS/LightRAG/pull/2733
  • Enhance current MilvusVectorDBStorage with parameterized configuration by @hanlianlu in https://github.com/HKUDS/LightRAG/pull/2672
  • fix: preserve failed-doc chunk metadata for reliable deletion cleanup by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2749
  • build(deps-dev): bump the ui-components group in /lightrag_webui with 2 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2750
  • build(deps): bump the frontend-minor-patch group in /lightrag_webui with 3 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2751
  • build(deps): bump the github-actions group with 4 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2759

New Contributors

  • @giulio-leone made their first contribution in https://github.com/HKUDS/LightRAG/pull/2725
  • @errajibadr made their first contribution in https://github.com/HKUDS/LightRAG/pull/2729
  • @Br1an67 made their first contribution in https://github.com/HKUDS/LightRAG/pull/2733
  • @hanlianlu made their first contribution in https://github.com/HKUDS/LightRAG/pull/2672

Full Changelog: https://github.com/HKUDS/LightRAG/compare/v1.4.10...v1.4.11rc2

View release on GitHub
v1.4.10 Maintenance
Notable features
  • Conditional pgvector extension support
  • Vietnamese i18n support
View release on GitHub
v1.4.9.11 New feature
Notable features
  • Vertex AI support for Gemini LLM
  • Korean localization with multi-language i18n
  • mdx file type support
Full changelog

Hot Fixed

  • Fix OpenAI LLM binding options not loaded from environment variables by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2585

What's New

  • feat(gemini): Add Vertex AI support for Gemini LLM binding by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2529

  • refact(gemini): Migrate Gemini LLM to native async Google GenAI client by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2531

  • Refact: Change DOCX extraction to use HTML tags for whitespace by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2550

  • feat: add Korean localization by @jhchoi1182 in https://github.com/HKUDS/LightRAG/pull/2571

  • Add support for mdx file type by @coldfire-x in https://github.com/HKUDS/LightRAG/pull/2566

  • Add i18n support for German, Ukrainian, Russian, and Japanese languages by @mlimarenko in https://github.com/HKUDS/LightRAG/pull/2547

What's Fixed

  • docs: fix the simple program rag init function return value in README.md by @Peefy in https://github.com/HKUDS/LightRAG/pull/2532
  • docs: fix the simple program rag init function return value in README-zh.md by @Peefy in https://github.com/HKUDS/LightRAG/pull/2534
  • feat: Implement WebUI Token Auto-Renewal (Sliding Window Expiration) by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2543
  • Fixes the Gemini integration example in the README by @vishvaRam in https://github.com/HKUDS/LightRAG/pull/2537
  • Add Gemini demo for LightRAG by @vishvaRam in https://github.com/HKUDS/LightRAG/pull/2538
  • Add LightRAG demo with PostgreSQL and Gemini integration by @vishvaRam in https://github.com/HKUDS/LightRAG/pull/2556
  • Update PostgreSQL demo script reference in README.md by @vishvaRam in https://github.com/HKUDS/LightRAG/pull/2557
  • Fix: Enhance PostgreSQL Reconnection Tolerance for HA Deployments by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2562
  • Add NEO4J_DATABASE variable to README by @vishvaRam in https://github.com/HKUDS/LightRAG/pull/2578
  • Bump the frontend-minor-patch group in /lightrag_webui with 2 updates by @dependabot[bot] in https://github.com/HKUDS/LightRAG/pull/2577
  • Add LightRAG demo script with vLLM integration by @vishvaRam in https://github.com/HKUDS/LightRAG/pull/2582

New Contributors

  • @Peefy made their first contribution in https://github.com/HKUDS/LightRAG/pull/2532
  • @vishvaRam made their first contribution in https://github.com/HKUDS/LightRAG/pull/2537
  • @mlimarenko made their first contribution in https://github.com/HKUDS/LightRAG/pull/2547
  • @jhchoi1182 made their first contribution in https://github.com/HKUDS/LightRAG/pull/2571
  • @coldfire-x made their first contribution in https://github.com/HKUDS/LightRAG/pull/2566

Full Changelog: https://github.com/HKUDS/LightRAG/compare/v1.4.9.10...v1.4.9.11

View release on GitHub

Beta — feedback welcome: [email protected]