v1.5.0rc1

HKUDS/LightRAGv1.5.0rc1Apr 26, 2026by danielaskdd

AI Summary

Release candidate for v1.5.0, introducing multimodal processing, role-specific LLMs, and structured extraction.

Key Highlights

  • Role-specific LLM configuration (EXTRACT, QUERY, KEYWORDS, VLM)
  • Task-aware embedding support
  • Structured extraction and multimodal pipeline integration
  • Full support for Amazon and Anthropic models on AWS Bedrock

Breaking Changes

  • ENTITY_TYPES environment variable deprecated (use ENTITY_TYPE_PROMPT_FILE)

New Features

  • Role-specific LLM configuration
  • Task-aware embedding support
  • Structured extraction integration
  • AWS Bedrock support

Full Release Notes

## Breaking Changes

* The `ENTITY_TYPES` environment variable has been deprecated; Please replace it with ENTITY_TYPE_PROMPT_FILE before launching this new version.

## Major Improvements

* Implement **role-specific LLM** configuration support, introducing four distinct roles—EXTRACT, QUERY, KEYWORDS, and VLM—each with independent LLM settings.
* 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.
* 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*.

## What's Changed
* 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 https://github.com/HKUDS/LightRAG/pull/2830 
* ♻️ refactor(documentManager): reorganize document status filtering by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2851
* feat: enhance entity extraction stability dev by @yunzhongxiaxi in https://github.com/HKUDS/LightRAG/pull/2864
* 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(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
* fix: remove `stream` parameter from `.parse()` call when `response_format` is present by @PaulTitto in https://github.com/HKUDS/LightRAG/pull/2965
* 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
* feat(bedrock): Rename `aws_bedrock` to `bedrock` and implement comprehensive option 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
* feat(prompt): externalize entity type extraction profiles by @danielaskdd in https://github.com/HKUDS/LightRAG/pull/2964
* 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 Podman-compatible compose file by @tears710 in https://github.com/HKUDS/LightRAG/pull/2983
* 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

## 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