v0.19.0

Released on May 26, 2025.

New features

• Cross-language search is supported in the Knowledge and Chat modules, enhancing search accuracy and user experience in multilingual environments, such as in Chinese-English knowledge bases.
• Agent component: A new Code component supports Python and JavaScript scripts, enabling developers to handle more complex tasks like dynamic data processing.
• Enhanced image display: Images in Chat and Search now render directly within responses, rather than as external references. Knowledge retrieval testing can retrieve images directly, instead of texts extracted from images.
• Claude 4 and ChatGPT o3: Developers can now use the newly released, most advanced Claude model alongside OpenAI’s latest ChatGPT o3 inference model.

The following features are contributed by our community contributors:

• Agent component: Enables tool calling within the Generate Component. Kudos to notsyncing.
• Markdown rendering: Image references in a markdown file can be displayed after chunking. Kudos to Woody-Hu.
• Document engine support: OpenSearch can now be used as RAGFlow's document engine. Kudos to pyyuhao.

What's Changed

• Feat: Create a folder #3221 by @cike8899 in #7228
• Feat: Deleting files in batches. #3221 by @cike8899 in #7234
• Fix/mcp doc by @yxkong in #7239
• Fix: improve retrieval API by @Woody-Hu in #6744
• Fix: mcp server start by @treywelsh in #7251
• chore: adds pre-commit by @wanpdsantos in #7242
• tag is missing. by @White-Bear1122 in #7256
• fix: task_executor bug fix by @benni82 in #7253
• Feat: Display document parsing status #3221 by @cike8899 in #7241
• Feat: Delete and rename files in the knowledge base #3221 by @cike8899 in #7268
• Feat: Adds OpenSearch2.19.1 as the vector_database support by @pyyuhao in #7140
• Docs: How to disable user registration by @writinwaters in #7265
• Feat: Replace the logo of novita by @neal-davis in #7287
• Fix: Qwen-vl-plus url error by @yongtenglei in #7281
• Doc: Updated sharing behavior in the open-source editions. by @writinwaters in #7293
• Feat: Display the document configuration dialog with shadcn #3221 by @cike8899 in #7302
• Fix pymysql interface error by @Yue-Lyu123 in #7295
• Fix: LLM generated tag issue. by @KevinHuSh in #7301
• Feat: Save the configuration information of the knowledge base document #3221 by @cike8899 in #7317
• Feat: Markdown add image by @Woody-Hu in #7124
• Feat: Save document metadata #3221 by @cike8899 in #7323
• Fix: Creating Knowledge Base Support Enter Key by @Woody-Hu in #7258
• DOC: Miscellaneous UI and editorial updates by @writinwaters in #7324
• Feat: Filter document by running status and file type. #3221 by @cike8899 in #7340
• Feat: Create empty document. #3221 by @cike8899 in #7343
• [BREAKING CHANGE] GET to POST: enhance document list capability by @yongtenglei in #7349
• Updated RAPTOR-specific UI by @writinwaters in #7348
• Feat: Batch operations on documents in a dataset #3221 by @cike8899 in #7352
• Update Groq AI Model Config by @wemod123 in #7335
• Fix: tenant_id spelling error. by @xiaosl-cell in #7331
• Fix mcp server startup failure by @yiminghub2024 in #7329
• Feat: Preview the file #3221 by @cike8899 in #7355
• perf: Optimize GraphRAG’s LOOP_PROMPT by @liuzhenghua in #7356
• feat: replace models of novita by @neal-davis in #7360
• Fix: Add title_tks for Pictures by @Woody-Hu in #7365
• Feat: Add AsyncTreeSelect component #3221 by @cike8899 in #7377
• Fix:Update chat assistant with an empty dataset by @NintendoLink in #7354
• Knowledge graph no longer exists as a chunking method by @writinwaters in #7382
• Feat: Add support for OAuth2 and OpenID Connect (OIDC) authentication by @wengchaoxi in #7379
• Refa: similarity calculations. by @KevinHuSh in #7381
• Feat: Bind data to the agent module of the home page #3221 by @cike8899 in #7385
• fixed missing list input ref in query by @isthaison in #7375
• Feat: Adjust the style of the home page #3221 by @cike8899 in #7405
• Fix: improve recover_pending_tasks timeout by @Woody-Hu in #7408
• Refa: http API create dataset and test cases by @asiroliu in #7393
• Feat: Modify the segmented component style #3221 by @cike8899 in #7409
• feat: dataset filter by parsing status by @Woody-Hu in #7404
• Feat: Add a language switch drop-down box to the top navigation bar #3221 by @cike8899 in #7416
• Feat: add Qwen3 and OpenAI o series by @yongtenglei in #7415
• Feat: Modify background color of Card #3221 by @cike8899 in #7421
• Fix: whole knowledge graph lost after removing any document in the knowledge base by @alkscr in #7151
• Feat: Using IconFont as an additional icon library #3221 by @cike8899 in #7427
• DOC: Added a UI tip for document parsing by @writinwaters in #7430
• Feat: filler list by user change input by @isthaison in #7389
• Test: Update tests to use new fixture instead of deprecated one by @asiroliu in #7431
• Fix: create dataset remove unnecessary parameter constraints by @asiroliu in #7432
• Fix: Tried to fix the fid mis match under some cases by @Woody-Hu in #7426
• Built-in reranker models have been removed from official deliveries. by @writinwaters in #7439
• Feat: Support passing knowledge base id as variable in retrieval component by @notsyncing in #7088
• Feat: Modify the dataset list page style #3221 by @cike8899 in #7437
• Fix: change create dataset htto api delimiter default value to r'\n' by @asiroliu in #7434
• Feat: Modify the style of the dataset page #3221 by @cike8899 in #7446
• Fix: filed_map was incorrectly persisted by @yongtenglei in #7443
• Fix instructions for Ollama by @raffaem in #7468
• Fix Ollama instructions by @raffaem in #7478
• Fix:Set CUDA_VISIBLE_DEVICES In DefaultEmbedding by @Woody-Hu in #7465
• fix(deps): incorrect nltk download dir by @kowyo in #7447
• fixed errror when vars of cnt begin declare with key contain "begin" by @isthaison in #7457
• perf: optimze figure parser by @liuzhenghua in #7392
• refa: Optimize create dataset validation by @asiroliu in #7451
• Fix: Sometimes VisionFigureParser.figures may is tuple by @Woody-Hu in #7477
• Fix: chat solo issue. by @KevinHuSh in #7479
• Feat: Support knowledge base type input in agent flow debugger by @notsyncing in #7471
• fix: After the file is deleted, it still remains in the bucket. by @liuzhenghua in #7482
• docs: add API key instructions for MCP host mode by @Monster-Beast in #7496
• Feat: Improve 'user_canvan_version' delete and 'document' delete performance by @Woody-Hu in #6553
• Fix:When sharing the knowledge base of multiple tenants with one person, when this person queries the knowledge base of both tenants, they will only query the question of the first person's knowledge base by @duramisu in #7500
• Fix: remove deprecated novitaAI. by @KevinHuSh in #7511
• Docs: Initial editorial pass to MCP server by @writinwaters in #7359
• Docs: minor format updates by @writinwaters in #7514
• Fix: retrieval component for shared KB issue. by @KevinHuSh in #7513
• Docs: correct wrong URL for related_questions HTTP API by @yongtenglei in #7507
• Feat: Add /login/channels route and improve auth logic for frontend third-party login integration by @wengchaoxi in #7521
• fix bug #7309 deepseek-ai/deepseek-vl2 model can not be select as a VL model to parse pdf image by @QuintinTao in #7312
• Feat: Add API to support get chunk by id by @Woody-Hu in #7522
• Refa: text order be robuster. by @KevinHuSh in #7525
• Feat: Adjust the operation cell of the table on the file management page and dataset page #3221. by @cike8899 in #7526
• Test: Configure test case priorities to reduce CI execution time by @asiroliu in #7532
• Updated MCP by @writinwaters in #7533
• Docs: UI updates by @writinwaters in #7536
• Error storing tag in Redis by @White-Bear1122 in #7541
• Fix:local_es_tag by @hfrt456 in #7534
• Feat: Replace the submit form button with ButtonLoading #3221 by @cike8899 in #7547
• CI: add daily test by @asiroliu in #7548
• Feat: KB detail supports document total size by @yongtenglei in #7546
• Feat: add document enabled by @LeiZhang-Hunter in #7549
• Fix: empty query issue. by @KevinHuSh in #7551
• Feat: Cross-language query #7376 #4503 #5710 #7470 by @cike8899 in #7554
• Feat: support cross-lang search. by @KevinHuSh in #7557
• Refa: remove ollama keep alive. by @KevinHuSh in #7560
• Perf: Increase database connection pool size by @asiroliu in #7559
• Fix: helm template redis by @gnowland in #7563
• Refa: HTTP API update dataset / test cases / docs by @asiroliu in #7564
• Test: skip unstable test cases by @asiroliu in #7578
• Docs: Restructured MCP-specific documents by @writinwaters in #7565
• feat: Enable antialiasing for PDF image extraction to improve OCR accuracy by @liuzhenghua in #7562
• docs: add langfuse documentation by @jannikmaierhoefer in #7568
• Set helm resource-policy to be keep by @wemod123 in #7574
• Fix:Discrepancy between Document.list_chunks() API documentation and implementation by @Woody-Hu in #7575
• Docs:Updated langfuse guide by @writinwaters in #7583
• add show debug by @isthaison in #7390
• Fix: InfiniteScroll sometimes can not fetch next page by @Woody-Hu in #7550
• Fix: markdown table conversion error by @alkscr in #7570
• Feat: Add http api to create, update, or delete agents. by @notsyncing in #7515
• Feat: add support for OpenAi gpt 4.1 series by @10Andrea10 in #7540
• Fix(api): correct default value handling in dataset parser config by @asiroliu in #7589
• Feat: Add FormContainer component #3221 by @cike8899 in #7588
• Docs: Guide on enabling Excel2HTML by @writinwaters in #7590
• Fix: missing graph resolution and community extraction in graphrag tasks by @alkscr in #7586
• FIX:ZeroDivisionError when using large page_size in client.retrieve() by @Woody-Hu in #7595
• Feat: Adjust the display position of recall test item images #7608 by @cike8899 in #7609
• Feat: add image preview to retrieval test. by @KevinHuSh in #7610
• Docs: Restructured docs by @writinwaters in #7614
• Feat: Fixed the issue where the chat page would jump after entering the homepage #3221 by @cike8899 in #7616
• Feat: let image citation being shown. by @KevinHuSh in #7624
• Feat: Show images in reply messages #7608 by @cike8899 in #7625
• Fix: file name length limit mismtach by @Woody-Hu in #7630
• FIX: knowledge will not render a paginator when count is greater than 30 by @Woody-Hu in #7596
• Feat: Add frontend support for third-party login integration by @wengchaoxi in #7553
• Fix: docx get image exception. by @KevinHuSh in #7636
• Docs: Update README.md by @FrozenZero in #7607
• Fix:Agent running message i10n by @Woody-Hu in #7635
• Docs: update 7 readme by @BadwomanCraZY in #7639
• Feat: Display inline (non-quoted) images in the chat and search modules #7623 by @cike8899 in #7638
• Feat: Add data set configuration form #3221 by @cike8899 in #7646
• Docs: Chat assistant relative time expressions were enabled in 0.17.1. by @writinwaters in #7647
• Feat: update llm factories for SILICONFLOW by @debugdoctor in #7620
• Fix: Anonymize profile input defaults by @gnowland in #7649
• Trival. by @KevinHuSh in #7653
• Docs: Miscellaneous UI updates by @writinwaters in #7648
• Feat: When Delete Chunk Will Also Delete Chunk Related Image by @Woody-Hu in #7656
• Fix: setuptools package definitions by @gnowland in #7654
• Fix: Setuptools project.license as a TOML table deprecation by @gnowland in #7652
• Refa: Deprecate /github_callback in favor of /oauth/callback/<channel> for GitHub OAuth integration by @wengchaoxi in #7587
• Docs: Added a guide on AI search by @writinwaters in #7674
• Feat: Add the JS code (or other) executor component to Agent. #4977 by @cike8899 in #7677
• Fix: Use DOMPurify to filter out dangerous HTML #7668 by @cike8899 in #7669
• Feat: Fixed the issue where the dataset configuration page kept refreshing #3221 by @cike8899 in #7666
• Refa: HTTP API delete dataset / test cases / docs by @asiroliu in #7657
• Feat: add code agent component by @yongtenglei in #7672
• Fix:Fail to get list_sessions by @Woody-Hu in #7678
• Feat: launch sandbox from docker-compose by @yongtenglei in #7671
• Fix: Fixed the issue where the height of the chat page shared externally did not fill the window #7460 by @cike8899 in #7682
• Test: use environment variable for ZHIPU_AI_API_KEY by @asiroliu in #7680
• Docs: Improve oauth configuration documentation and examples by @wengchaoxi in #7675
• Test: change variable for ZHIPU_AI_API_KEY by @asiroliu in #7684
• Docs: Added contribution guidelines and sandbox-related tips by @writinwaters in #7685
• Feat: Support tool calling in Generate component by @notsyncing in #7572
• Fix: Fixed the issue where message references could not be displayed by @cike8899 in #7691
• Feat: Rendering recall test page #3221 by @cike8899 in #7689
• Docs: Added a guide on switching document engine by @writinwaters in #7692
• Docs: Added an FAQ by @writinwaters in #7694
• Fix: value too long error for chat name by @notsyncing in #7697
• fix: Fix the problem that concurrent execution limit in task executor fails and causes OOM (issue#7580) by @S0b3Rr in #7700
• When creating an assistant, no dataset is specified, a different default system promt is used by @liwenju0 in #7690
• Feat: repair corrupted PDF files on upload automatically by @yongtenglei in #7693
• Fix: uncaptured image data with position information by @yongtenglei in #7683
• Refa: more fallbacks for bad citation format by @yongtenglei in #7710
• Feat: Modify the Python language template code of the code operator #4977 by @cike8899 in #7714
• Fix:When you create a new API module named xxxa_api, the access route will become xxx instead of xxxa. For example, when I create a new API module named 'data_api', the access route will become 'dat' instead of 'data by @donblack01 in #7325
• Feat: Add OAuth state parameter for CSRF protection by @wengchaoxi in #7709
• Refa: HTTP API list datasets / test cases / docs by @asiroliu in #7720
• Feat: The image displayed in the reply message can also be clicked to display the location of the source document where the slice is located #7623 by @cike8899 in #7723
• Feat: sandox enhancement by @yongtenglei in #7739
• Fix: wrong type hint by @yongtenglei in #7738
• Feat: change default models by @asiroliu in #7777
• Feat: more robust fallbacks for citations by @yongtenglei in #7801
• Feat: add claude4 models by @yongtenglei in #7809
• Docs: Added instructions on cross-language search (#7812) by @writinwaters in #7813
• Docs: Added v0.19.0 release notes by @writinwaters in #7818
• Docs: update for v0.19.0 by @asiroliu in #7823
• Docs: Added code component reference by @writinwaters in #7821
• Refa: update gemini2.5 by @yongtenglei in #7822
• Fix: Fixed the issue that the script text of the code operator is not displayed after refreshing the page after saving the script text of the code operator #4977 by @cike8899 in #7826
• Fix: catch non-begin component output by @yongtenglei in #7827

New Contributors

• @yxkong made their first contribution in #7239
• @treywelsh made their first contribution in #7251
• @White-Bear1122 made their first contribution in #7256
• @pyyuhao made their first contribution in #7140
• @neal-davis made their first contribution in #7287
• @wemod123 made their first contribution in #7335
• @xiaosl-cell made their first contribution in #7331
• @yiminghub2024 made their first contribution in #7329
• @NintendoLink made their first contribution in #7354
• @wengchaoxi made their first contribution in #7379
• @raffaem made their first contribution in #7468
• @kowyo made their first contribution in #7447
• @Monster-Beast made their first contribution in #7496
• @duramisu made their first contribution in #7500
• @hfrt456 made their first contribution in #7534
• @LeiZhang-Hunter made their first contribution in #7549
• @gnowland made their first contribution in #7563
• @jannikmaierhoefer made their first contribution in #7568
• @10Andrea10 made their first contribution in #7540
• @FrozenZero made their first contribution in #7607
• @S0b3Rr made their first contribution in #7700

Full Changelog: v0.18.0...v0.19.0