ragflow
v1.0.0RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.
- Maintenance
- Active2843 commits in 3 months · bus factor 7
- License
- Apache-2.0Permissive · OSI-approved
- Security
- 8 advisories5 critical, 3 high
- Supported versions
- No scheduleendoflife.date does not track this project
94.2k stars · 11.3k forks · 1.3k open issues · last release 9 days ago · data checked 4 hours ago
Breaking changes
What to check before upgrading, taken from the notes of the last 30 releases.
- v0.22.0Nov 12, 2025
Breaking Changes
- From this release onwards, we ship only the slim edition (without embedding models) Docker image and no longer append the
-slimsuffix to the image tag.
- From this release onwards, we ship only the slim edition (without embedding models) Docker image and no longer append the
Release history
All releases on GitHubAtom feed/feed/infiniflow/ragflow
Badge
[](/p/infiniflow/ragflow)
After three release candidates, we are pleased to announce the official release of RAGFlow 1.0, now ready for production. Built on a complete rewrite in Go, this release significantly reduces deployment and runtime overhead and introduces an all-new Agentic Chat experience. We encourage all users to upgrade for improved stability, performance, and question answering.
Highlights
- Rewritten in Go for lighter deployment: Docker images are approximately 10× smaller, and startup is approximately 10× faster.
- Approximately 100× greater concurrency, with substantial improvements in query latency, memory usage, and document parsing speed.
- All-new Agentic Chat: Enables multi-step reasoning and answers to complex questions through iterative retrieval, tool calls, and evidence sufficiency assessment.
Chat and Agents
- Added Agentic Chat mode, replacing the previous Low, Medium, High, and Ultra thinking levels.
- Introduced the Jev decision model into the agent tool-calling loop to determine whether the available evidence is sufficient to answer a question.
- Added support for the Jev decision model in the Categorize agent component.
- Added storage and display of prompts, token usage, and execution time in chat history.
Document Ingestion and Retrieval
- Unified the 12 built-in document parsers with the pipeline parsers.
- Added support for multiple ingestion pipeline DSL versions.
Architecture and Deployment
- Migrated the message queue from Redis to NATS.
- Adopted Kvrocks for cache and checkpoint storage.
- Added Docker images for the arm64 architecture.
- Reimplemented the RAGFlow CLI in Go.
Stability
- Fixed multiple critical bugs reported by the community and issues identified during the release candidate phase, further improving runtime stability.
Benchmarks
- Achieved 91% accuracy on the FRAMES multi-hop question-answering benchmark using RAGFlow Agentic Chat with MiniMax M3.
Upgrading
- From v1.0.0-rc1, rc2, or rc3: Existing data is fully compatible. You can upgrade directly.
- From v0.27.2: You can upgrade directly to v1.0.0. Data migration runs automatically when the RAGFlow Docker container starts.
- From versions earlier than v0.27.2: Follow the migration guide to complete the required intermediate upgrades before upgrading to v1.0.0.
- Back up all data before upgrading. Data migration from v0.27.2 to v1.0.0 is irreversible. If migration fails, restore the complete pre-upgrade backup before trying again.
Compatibility and Limitations
- Deprecated API aliases are no longer supported.
- The Python SDK is unaffected.
- DeepDoc currently supports CPU environments only.
Relative references
- Backup and upgrade guide: https://ragflow.io/docs/migration_overview
- Removed APIs: https://ragflow.io/docs/http_api_reference#removed-api-aliases
What's Changed
- fix(parser): keep recovered PDF TOC leader lines out of the body guard by @jay77721 in https://github.com/infiniflow/ragflow/pull/21768
- CI: Fix log tee failure by @myf-bee in https://github.com/infiniflow/ragflow/pull/21791
- Update release notes of 1.0.0.rc3 by @yingfeng in https://github.com/infiniflow/ragflow/pull/21793
- feat: add Wally as a model provider by @adityabatra072 in https://github.com/infiniflow/ragflow/pull/21719
- add audit hooks to file APIs by @JinHai-CN in https://github.com/infiniflow/ragflow/pull/21807
- add log hooks by @JinHai-CN in https://github.com/infiniflow/ragflow/pull/21822
- i18n: translate pipeline version and parser settings strings in tr-TR by @bakiburakogun in https://github.com/infiniflow/ragflow/pull/21819
- fix(models): honour context cancellation in driver HTTP requests by @ccclucky in https://github.com/infiniflow/ragflow/pull/21643
- feat(vastbase): support Vastbase G100 as the metadata database in Go by @FengYikai710 in https://github.com/infiniflow/ragflow/pull/20913
- fix: README.md by @eridan-ltu in https://github.com/infiniflow/ragflow/pull/21828
- fix(chunker): prevent PDF child chunks from overwriting each other by @jay77721 in https://github.com/infiniflow/ragflow/pull/21773
- test(sdk): remove explicit Python SDK test skips by @6ba3i in https://github.com/infiniflow/ragflow/pull/21783
- fix(syncer): retain Dropbox checkpoints on download failure by @Zhi-Xiang-Guo in https://github.com/infiniflow/ragflow/pull/21809
- fix(api): keep the datasets API error response body shape by @simpleqt in https://github.com/infiniflow/ragflow/pull/21831
- perf(web): virtualize chat message lists by @dcc123456 in https://github.com/infiniflow/ragflow/pull/21790
- CI: add check for ASCII, disallow none ASCII code check-in by @wangq8 in https://github.com/infiniflow/ragflow/pull/21784
- fix(anthropic): support struct json schema in tool parameters by @Sanderhoff-alt in https://github.com/infiniflow/ragflow/pull/21638
- feat(parser): hand off Markdown and HTML remote images as media refs by @jay77721 in https://github.com/infiniflow/ragflow/pull/21764
- fix(paddleocr): handle submit request creation errors by @QAQadws in https://github.com/infiniflow/ragflow/pull/21839
- fix(deepdoc): add cgo constraints to native configuration tests by @QAQadws in https://github.com/infiniflow/ragflow/pull/21837
- fix: SoMark web page is missing by @fenglingxiansheng in https://github.com/infiniflow/ragflow/pull/21710
- fix(agent): clamp dataset navigation max_docs to the default budget by @flyingwhit in https://github.com/infiniflow/ragflow/pull/21755
- feat(admin): add user search, status filtering, sorting, and CLI pagination by @QAQadws in https://github.com/infiniflow/ragflow/pull/21729
- feat(chat): add AnySearch web search provider by @GunaPalanivel in https://github.com/infiniflow/ragflow/pull/20633
- refa: consolidate model access and tenant defaults by @buua436 in https://github.com/infiniflow/ragflow/pull/21740