|
--- |
|
sidebar_position: 2 |
|
slug: /release_notes |
|
--- |
|
|
|
# Releases |
|
|
|
Key features, improvements and bug fixes in the latest releases. |
|
|
|
## v0.17.2 |
|
|
|
Released on March 13, 2025. |
|
|
|
### Improvements |
|
|
|
- Adds OpenAI-compatible APIs. |
|
- Introduces a German user interface. |
|
- Accelerates knowledge graph extraction. |
|
- Enables Tavily-based web search in the **Retrieval** agent component. |
|
- Adds Tongyi-Qianwen QwQ models (OpenAI-compatible). |
|
- Supports CSV files in the **General** chunk method. |
|
|
|
### Fixed issues |
|
|
|
- Unable to add models via Ollama/Xinference, an issue introduced in v0.17.1. |
|
|
|
### Related APIs |
|
|
|
#### HTTP APIs |
|
|
|
[Create chat completion](./references/http_api_reference.md#openai-compatible-api) |
|
|
|
#### Python APIs |
|
|
|
[Create chat completion](./references/python_api_reference.md#openai-compatible-api) |
|
|
|
## v0.17.1 |
|
|
|
Released on March 11, 2025. |
|
|
|
### Improvements |
|
|
|
- Improves English tokenization quality. |
|
- Improves the table extraction logic in Markdown document parsing. |
|
- Updates SiliconFlow's model list. |
|
- Supports parsing XLS files (Excel97~2003) with improved corresponding error handling. |
|
- Supports Huggingface rerank models. |
|
- Enables relative time expressions ("now", "yesterday", "last week", "next year", and more) in the **Rewrite** agent component. |
|
|
|
### Fixed issues |
|
|
|
- A repetitive knowledge graph extraction issue. |
|
- Issues with API calling. |
|
- Options in the **Document parser** dropdown are missing. |
|
- A Tavily web search issue. |
|
- Unable to preview diagrams or images in an AI chat. |
|
|
|
### Documentation |
|
|
|
#### Added documents |
|
|
|
[Use tag set](./guides/dataset/use_tag_sets.md) |
|
|
|
## v0.17.0 |
|
|
|
Released on March 3, 2025. |
|
|
|
### New features |
|
|
|
- AI chat: Implements Deep Research for agentic reasoning. To activate this, enable the **Reasoning** toggle under the **Prompt Engine** tab of your chat assistant dialogue. |
|
- AI chat: Leverages Tavily-based web search to enhance contexts in agentic reasoning. To activate this, enter the correct Tavily API key under the **Assistant Setting** tab of your chat assistant dialogue. |
|
- AI chat: Supports starting a chat without specifying knowledge bases. |
|
- AI chat: HTML files can also be previewed and referenced, in addition to PDF files. |
|
- Dataset: Adds a **Document parser** dropdown menu to dataset configurations. This includes a DeepDoc model option, which is time-consuming, a much faster **naive** option (plain text), which skips DLA (Document Layout Analysis), OCR (Optical Character Recognition), and TSR (Table Structure Recognition) tasks, and several currently *experimental* large model options. |
|
- Agent component: **(x)** or a forward slash `/` can be used to insert available keys (variables) in the system prompt field of the **Generate** or **Template** component. |
|
- Object storage: Supports using Aliyun OSS (Object Storage Service) as a file storage option. |
|
- Models: Updates the supported model list for Tongyi-Qianwen (Qwen), adding DeepSeek-specific models; adds ModelScope as a model provider. |
|
- APIs: Document metadata can be updated through an API. |
|
|
|
The following diagram illustrates the workflow of RAGFlow's Deep Research: |
|
|
|
 |
|
|
|
The following is a screenshot of a conversation that integrates Deep Research: |
|
|
|
 |
|
|
|
### Related APIs |
|
|
|
#### HTTP APIs |
|
|
|
Adds a body parameter `"meta_fields"` to the [Update document](./references/http_api_reference.md#update-document) method. |
|
|
|
#### Python APIs |
|
|
|
Adds a key option `"meta_fields"` to the [Update document](./references/python_api_reference.md#update-document) method. |
|
|
|
### Documentation |
|
|
|
#### Added documents |
|
|
|
[Run retrieval test](./guides/dataset/run_retrieval_test.md) |
|
|
|
## v0.16.0 |
|
|
|
Released on February 6, 2025. |
|
|
|
### New features |
|
|
|
- Supports DeepSeek R1 and DeepSeek V3. |
|
- GraphRAG refactor: Knowledge graph is dynamically built on an entire knowledge base (dataset) rather than on an individual file, and automatically updated when a newly uploaded file starts parsing. See [here](https://ragflow.io/docs/dev/construct_knowledge_graph). |
|
- Adds an **Iteration** agent component and a **Research report generator** agent template. See [here](./guides/agent/agent_component_reference/iteration.mdx). |
|
- New UI language: Portuguese. |
|
- Allows setting metadata for a specific file in a knowledge base to enhance AI-powered chats. See [here](./guides/dataset/set_metadata.md). |
|
- Upgrades RAGFlow's document engine [Infinity](https://github.com/infiniflow/infinity) to v0.6.0.dev3. |
|
- Supports GPU acceleration for DeepDoc (see [docker-compose-gpu.yml](https://github.com/infiniflow/ragflow/blob/main/docker/docker-compose-gpu.yml)). |
|
- Supports creating and referencing a **Tag** knowledge base as a key milestone towards bridging the semantic gap between query and response. |
|
|
|
:::danger IMPORTANT |
|
The **Tag knowledge base** feature is *unavailable* on the [Infinity](https://github.com/infiniflow/infinity) document engine. |
|
::: |
|
|
|
### Documentation |
|
|
|
#### Added documents |
|
|
|
- [Construct knowledge graph](./guides/dataset/construct_knowledge_graph.md) |
|
- [Set metadata](./guides/dataset/set_metadata.md) |
|
- [Begin component](./guides/agent/agent_component_reference/begin.mdx) |
|
- [Generate component](./guides/agent/agent_component_reference/generate.mdx) |
|
- [Interact component](./guides/agent/agent_component_reference/interact.mdx) |
|
- [Retrieval component](./guides/agent/agent_component_reference/retrieval.mdx) |
|
- [Categorize component](./guides/agent/agent_component_reference/categorize.mdx) |
|
- [Keyword component](./guides/agent/agent_component_reference/keyword.mdx) |
|
- [Message component](./guides/agent/agent_component_reference/message.mdx) |
|
- [Rewrite component](./guides/agent/agent_component_reference/rewrite.mdx) |
|
- [Switch component](./guides/agent/agent_component_reference/switch.mdx) |
|
- [Concentrator component](./guides/agent/agent_component_reference/concentrator.mdx) |
|
- [Template component](./guides/agent/agent_component_reference/template.mdx) |
|
- [Iteration component](./guides/agent/agent_component_reference/iteration.mdx) |
|
- [Note component](./guides/agent/agent_component_reference/note.mdx) |
|
|
|
## v0.15.1 |
|
|
|
Released on December 25, 2024. |
|
|
|
### Upgrades |
|
|
|
- Upgrades RAGFlow's document engine [Infinity](https://github.com/infiniflow/infinity) to v0.5.2. |
|
- Enhances the log display of document parsing status. |
|
|
|
### Fixed issues |
|
|
|
This release fixes the following issues: |
|
|
|
- The `SCORE not found` and `position_int` errors returned by [Infinity](https://github.com/infiniflow/infinity). |
|
- Once an embedding model in a specific knowledge base is changed, embedding models in other knowledge bases can no longer be changed. |
|
- Slow response in question-answering and AI search due to repetitive loading of the embedding model. |
|
- Fails to parse documents with RAPTOR. |
|
- Using the **Table** parsing method results in information loss. |
|
- Miscellaneous API issues. |
|
|
|
### Related APIs |
|
|
|
#### HTTP APIs |
|
|
|
Adds an optional parameter `"user_id"` to the following APIs: |
|
|
|
- [Create session with chat assistant](https://ragflow.io/docs/dev/http_api_reference#create-session-with-chat-assistant) |
|
- [Update chat assistant's session](https://ragflow.io/docs/dev/http_api_reference#update-chat-assistants-session) |
|
- [List chat assistant's sessions](https://ragflow.io/docs/dev/http_api_reference#list-chat-assistants-sessions) |
|
- [Create session with agent](https://ragflow.io/docs/dev/http_api_reference#create-session-with-agent) |
|
- [Converse with chat assistant](https://ragflow.io/docs/dev/http_api_reference#converse-with-chat-assistant) |
|
- [Converse with agent](https://ragflow.io/docs/dev/http_api_reference#converse-with-agent) |
|
- [List agent sessions](https://ragflow.io/docs/dev/http_api_reference#list-agent-sessions) |
|
|
|
## v0.15.0 |
|
|
|
Released on December 18, 2024. |
|
|
|
### New features |
|
|
|
- Introduces additional Agent-specific APIs. |
|
- Supports using page rank score to improve retrieval performance when searching across multiple knowledge bases. |
|
- Offers an iframe in Chat and Agent to facilitate the integration of RAGFlow into your webpage. |
|
- Adds a Helm chart for deploying RAGFlow on Kubernetes. |
|
- Supports importing or exporting an agent in JSON format. |
|
- Supports step run for Agent components/tools. |
|
- Adds a new UI language: Japanese. |
|
- Supports resuming GraphRAG and RAPTOR from a failure, enhancing task management resilience. |
|
- Adds more Mistral models. |
|
- Adds a dark mode to the UI, allowing users to toggle between light and dark themes. |
|
|
|
### Improvements |
|
|
|
- Upgrades the Document Layout Analysis model in DeepDoc. |
|
- Significantly enhances the retrieval performance when using [Infinity](https://github.com/infiniflow/infinity) as document engine. |
|
|
|
### Related APIs |
|
|
|
#### HTTP APIs |
|
|
|
- [List agent sessions](https://ragflow.io/docs/dev/http_api_reference#list-agent-sessions) |
|
- [List agents](https://ragflow.io/docs/dev/http_api_reference#list-agents) |
|
|
|
#### Python APIs |
|
|
|
- [List agent sessions](https://ragflow.io/docs/dev/python_api_reference#list-agent-sessions) |
|
- [List agents](https://ragflow.io/docs/dev/python_api_reference#list-agents) |
|
|
|
## v0.14.1 |
|
|
|
Released on November 29, 2024. |
|
|
|
### Improvements |
|
|
|
Adds [Infinity's configuration file](https://github.com/infiniflow/ragflow/blob/main/docker/infinity_conf.toml) to facilitate integration and customization of [Infinity](https://github.com/infiniflow/infinity) as a document engine. From this release onwards, updates to Infinity's configuration can be made directly within RAGFlow and will take effect immediately after restarting RAGFlow using `docker compose`. [#3715](https://github.com/infiniflow/ragflow/pull/3715) |
|
|
|
### Fixed issues |
|
|
|
This release fixes the following issues: |
|
|
|
- Unable to display or edit content of a chunk after clicking it. |
|
- A `'Not found'` error in Elasticsearch. |
|
- Chinese text becoming garbled during parsing. |
|
- A compatibility issue with Polars. |
|
- A compatibility issue between Infinity and GraphRAG. |
|
|
|
## v0.14.0 |
|
|
|
Released on November 26, 2024. |
|
|
|
### New features |
|
|
|
- Supports [Infinity](https://github.com/infiniflow/infinity) or Elasticsearch (default) as document engine for vector storage and full-text indexing. [#2894](https://github.com/infiniflow/ragflow/pull/2894) |
|
- Enhances user experience by adding more variables to the Agent and implementing auto-saving. |
|
- Adds a three-step translation agent template, inspired by [Andrew Ng's translation agent](https://github.com/andrewyng/translation-agent). |
|
- Adds an SEO-optimized blog writing agent template. |
|
- Provides HTTP and Python APIs for conversing with an agent. |
|
- Supports the use of English synonyms during retrieval processes. |
|
- Optimizes term weight calculations, reducing the retrieval time by 50%. |
|
- Improves task executor monitoring with additional performance indicators. |
|
- Replaces Redis with Valkey. |
|
- Adds three new UI languages (*contributed by the community*): Indonesian, Spanish, and Vietnamese. |
|
|
|
### Compatibility changes |
|
|
|
As of this release, **service_config.yaml.template** replaces **service_config.yaml** for configuring backend services. Upon Docker container startup, the environment variables defined in this template file are automatically populated and a **service_config.yaml** is auto-generated from it. [#3341](https://github.com/infiniflow/ragflow/pull/3341) |
|
|
|
This approach eliminates the need to manually update **service_config.yaml** after making changes to **.env**, facilitating dynamic environment configurations. |
|
|
|
:::danger IMPORTANT |
|
Ensure that you [upgrade **both** your code **and** Docker image to this release](https://ragflow.io/docs/dev/upgrade_ragflow#upgrade-ragflow-to-the-most-recent-officially-published-release) before trying this new approach. |
|
::: |
|
|
|
### Related APIs |
|
|
|
#### HTTP APIs |
|
|
|
- [Create session with agent](https://ragflow.io/docs/dev/http_api_reference#create-session-with-agent) |
|
- [Converse with agent](https://ragflow.io/docs/dev/http_api_reference#converse-with-agent) |
|
|
|
#### Python APIs |
|
|
|
- [Create session with agent](https://ragflow.io/docs/dev/python_api_reference#create-session-with-agent) |
|
- [Converse with agent](https://ragflow.io/docs/dev/python_api_reference#create-session-with-agent) |
|
|
|
### Documentation |
|
|
|
#### Added documents |
|
|
|
- [Configurations](https://ragflow.io/docs/dev/configurations) |
|
- [Manage team members](https://ragflow.io/docs/dev/manage_team_members) |
|
- [Run health check on RAGFlow's dependencies](https://ragflow.io/docs/dev/run_health_check) |
|
|
|
## v0.13.0 |
|
|
|
Released on October 31, 2024. |
|
|
|
### New features |
|
|
|
- Adds the team management functionality for all users. |
|
- Updates the Agent UI to improve usability. |
|
- Adds support for Markdown chunking in the **General** chunk method. |
|
- Introduces an **invoke** tool within the Agent UI. |
|
- Integrates support for Dify's knowledge base API. |
|
- Adds support for GLM4-9B and Yi-Lightning models. |
|
- Introduces HTTP and Python APIs for dataset management, file management within dataset, and chat assistant management. |
|
|
|
:::tip NOTE |
|
To download RAGFlow's Python SDK: |
|
|
|
```bash |
|
pip install ragflow-sdk==0.13.0 |
|
``` |
|
::: |
|
|
|
### Documentation |
|
|
|
#### Added documents |
|
|
|
- [Acquire a RAGFlow API key](./develop/acquire_ragflow_api_key.md) |
|
- [HTTP API Reference](./references/http_api_reference.md) |
|
- [Python API Reference](./references/python_api_reference.md) |
|
|
|
## v0.12.0 |
|
|
|
Released on September 30, 2024. |
|
|
|
### New features |
|
|
|
- Offers slim editions of RAGFlow's Docker images, which do not include built-in BGE/BCE embedding or reranking models. |
|
- Improves the results of multi-round dialogues. |
|
- Enables users to remove added LLM vendors. |
|
- Adds support for **OpenTTS** and **SparkTTS** models. |
|
- Implements an **Excel to HTML** toggle in the **General** chunk method, allowing users to parse a spreadsheet into either HTML tables or key-value pairs by row. |
|
- Adds agent tools **YahooFinance** and **Jin10**. |
|
- Adds an investment advisor agent template. |
|
|
|
### Compatibility changes |
|
|
|
As of this release, RAGFlow offers slim editions of its Docker images to improve the experience for users with limited Internet access. A slim edition of RAGFlow's Docker image does not include built-in BGE/BCE embedding models and has a size of about 1GB; a full edition of RAGFlow is approximately 9GB and includes both built-in embedding models and embedding models that will be downloaded once you select them in the RAGFlow UI. |
|
|
|
The default Docker image edition is `nightly-slim`. The following list clarifies the differences between various editions: |
|
|
|
- `nightly-slim`: The slim edition of the most recent tested Docker image. |
|
- `v0.12.0-slim`: The slim edition of the most recent **officially released** Docker image. |
|
- `nightly`: The full edition of the most recent tested Docker image. |
|
- `v0.12.0`: The full edition of the most recent **officially released** Docker image. |
|
|
|
See [Upgrade RAGFlow](https://ragflow.io/docs/dev/upgrade_ragflow) for instructions on upgrading. |
|
|
|
### Documentation |
|
|
|
#### Added documents |
|
|
|
- [Upgrade RAGFlow](https://ragflow.io/docs/dev/upgrade_ragflow) |
|
|
|
## v0.11.0 |
|
|
|
Released on September 14, 2024. |
|
|
|
### New features |
|
|
|
- Introduces an AI search interface within the RAGFlow UI. |
|
- Supports audio output via **FishAudio** or **Tongyi Qwen TTS**. |
|
- Allows the use of Postgres for metadata storage, in addition to MySQL. |
|
- Supports object storage options with S3 or Azure Blob. |
|
- Supports model vendors: **Anthropic**, **Voyage AI**, and **Google Cloud**. |
|
- Supports the use of **Tencent Cloud ASR** for audio content recognition. |
|
- Adds finance-specific agent components: **WenCai**, **AkShare**, **YahooFinance**, and **TuShare**. |
|
- Adds a medical consultant agent template. |
|
- Supports running retrieval benchmarking on the following datasets: |
|
- [ms_marco_v1.1](https://huggingface.co/datasets/microsoft/ms_marco) |
|
- [trivia_qa](https://huggingface.co/datasets/mandarjoshi/trivia_qa) |
|
- [miracl](https://huggingface.co/datasets/miracl/miracl) |
|
|
|
## v0.10.0 |
|
|
|
Released on August 26, 2024. |
|
|
|
### New features |
|
|
|
- Introduces a text-to-SQL template in the Agent UI. |
|
- Implements Agent APIs. |
|
- Incorporates monitoring for the task executor. |
|
- Introduces Agent tools **GitHub**, **DeepL**, **BaiduFanyi**, **QWeather**, and **GoogleScholar**. |
|
- Supports chunking of EML files. |
|
- Supports more LLMs or model services: **GPT-4o-mini**, **PerfXCloud**, **TogetherAI**, **Upstage**, **Novita.AI**, **01.AI**, **SiliconFlow**, **PPIO**, **XunFei Spark**, **Baidu Yiyan**, and **Tencent Hunyuan**. |
|
|
|
## v0.9.0 |
|
|
|
Released on August 6, 2024. |
|
|
|
### New features |
|
|
|
- Supports GraphRAG as a chunk method. |
|
- Introduces Agent component **Keyword** and search tools, including **Baidu**, **DuckDuckGo**, **PubMed**, **Wikipedia**, **Bing**, and **Google**. |
|
- Supports speech-to-text recognition for audio files. |
|
- Supports model vendors **Gemini** and **Groq**. |
|
- Supports inference frameworks, engines, and services including **LM studio**, **OpenRouter**, **LocalAI**, and **Nvidia API**. |
|
- Supports using reranker models in Xinference. |
|
|
|
## v0.8.0 |
|
|
|
Released on July 8, 2024. |
|
|
|
### New features |
|
|
|
- Supports Agentic RAG, enabling graph-based workflow construction for RAG and agents. |
|
- Supports model vendors **Mistral**, **MiniMax**, **Bedrock**, and **Azure OpenAI**. |
|
- Supports DOCX files in the MANUAL chunk method. |
|
- Supports DOCX, MD, and PDF files in the Q&A chunk method. |
|
|
|
## v0.7.0 |
|
|
|
Released on May 31, 2024. |
|
|
|
### New features |
|
|
|
- Supports the use of reranker models. |
|
- Integrates reranker and embedding models: [BCE](https://github.com/netease-youdao/BCEmbedding), [BGE](https://github.com/FlagOpen/FlagEmbedding), and [Jina](https://jina.ai/embeddings/). |
|
- Supports LLMs Baichuan and VolcanoArk. |
|
- Implements [RAPTOR](https://arxiv.org/html/2401.18059v1) for improved text retrieval. |
|
- Supports HTML files in the GENERAL chunk method. |
|
- Provides HTTP and Python APIs for deleting documents by ID. |
|
- Supports ARM64 platforms. |
|
|
|
:::danger IMPORTANT |
|
While we also test RAGFlow on ARM64 platforms, we do not maintain RAGFlow Docker images for ARM. |
|
|
|
If you are on an ARM platform, follow [this guide](./develop/build_docker_image.mdx) to build a RAGFlow Docker image. |
|
::: |
|
|
|
### Related APIs |
|
|
|
#### HTTP API |
|
|
|
- [Delete documents](https://ragflow.io/docs/dev/http_api_reference#delete-documents) |
|
|
|
#### Python API |
|
|
|
- [Delete documents](https://ragflow.io/docs/dev/python_api_reference#delete-documents) |
|
|
|
## v0.6.0 |
|
|
|
Released on May 21, 2024. |
|
|
|
### New features |
|
|
|
- Supports streaming output. |
|
- Provides HTTP and Python APIs for retrieving document chunks. |
|
- Supports monitoring of system components, including Elasticsearch, MySQL, Redis, and MinIO. |
|
- Supports disabling **Layout Recognition** in the GENERAL chunk method to reduce file chunking time. |
|
|
|
### Related APIs |
|
|
|
#### HTTP API |
|
|
|
- [Retrieve chunks](https://ragflow.io/docs/dev/http_api_reference#retrieve-chunks) |
|
|
|
#### Python API |
|
|
|
- [Retrieve chunks](https://ragflow.io/docs/dev/python_api_reference#retrieve-chunks) |
|
|
|
## v0.5.0 |
|
|
|
Released on May 8, 2024. |
|
|
|
### New features |
|
|
|
- Supports LLM DeepSeek. |
|
|
