OpenRAG 是什么?
OpenRAG 是一个检索增强生成平台:你把文档加入知识库,然后在聊天界面里向 AI 智能体提问。项目把它描述为用于构建智能体 RAG 系统的开源软件包,组合了三个现有项目:用 Langflow 做智能体流程,用 OpenSearch 存储文档和向量,用 Docling 解析并切分文件。
它在 langflow-ai/openrag 仓库中开发,后端是 FastAPI,前端是 Next.js。文档位于 docs.openr.ag。
获取方式
OpenRAG 不是可下载的桌面应用:你在终端里用 uv 安装,它随后会启动自己的容器。
方式 | 获取方式 |
|---|---|
| 快速入门(macOS、Linux) | 在空文件夹中运行 uvx --python 3.13 openrag |
| Windows | 同一条命令,但仅限在 WSL 内运行(见运行要求) |
| Python 项目 | 按安装选项,用 uv 作为依赖添加 |
| 自行管理 | 按 Docker 指南,用 Docker 或 Podman 和你自己的 .env 文件 |
| 官网 | openr.ag |
| 文档 | docs.openr.ag |
| 源代码 | github.com/langflow-ai/openrag |
| 隐私政策 | 未找到 OpenRAG 专属页面;文档的同意设置引用 IBM 隐私声明 |
评测版本:v0.8.0,据 GitHub 发布页于 2026 年 10 月 1 日发布;仓库本身最近一次更新在 2026 年 10 月 23 日。该版本只提供 Python wheel 包和源码压缩包,没有安装程序或桌面版,因此需要终端和开发环境。
运行要求
文档要求有容器运行环境、8 GB 内存和超过 50 GB 的可用磁盘空间。
项目 | 文档说明 |
|---|---|
| Python 与 uv | 快速入门要求 Python 3.13 和 uv |
| 容器运行环境 | Docker 或 Podman 加 compose 工具;缺失时 uvx 会安装一个 |
| 内存 | 8 GB 为建议的最低配置 |
| 磁盘 | 初始设置和导入需超过 50 GB 空闲空间 |
| Windows | 仅限 WSL 内;不支持 Windows 虚拟机里的 WSL 发行版 |
| 本地模型 | 通过 Ollama 运行 gpt-oss:20b 至少需要 16 GB 内存 |
所查页面没有给出 OpenRAG 本身的 GPU 要求,只说明要使用 GPU,Ollama 必须在支持 GPU 的容器中运行。
上手步骤
以下步骤依据项目的快速入门;PromptQuorum 没有实际运行过。
- 1创建工作文件夹
Why it matters: 新建一个空目录,例如 openrag-workspace,并在其中打开终端。 - 2启动安装程序
Why it matters: 运行 uvx --python 3.13 openrag,会打开一个终端界面。 - 3设置管理员密码
Why it matters: 为 OpenSearch 和 Langflow 自动生成或手动输入管理员密码;其余提示可跳过以保留默认值。 - 4启动服务
Why it matters: 对 “Start services now?” 回答 Y,等待出现 “Services are running”,再在浏览器中打开 OpenRAG。 - 5完成初始引导
Why it matters: 选择模型提供商,输入其 API 密钥并点击 Complete;快速入门使用的是 OpenAI。 - 6添加知识并开始聊天
Why it matters: 上传文件或文件夹,然后在聊天视图中提问。
来源已证实的功能
以下每一项都来自项目的文档或 README。
- 可编辑的流程。内置的智能体流程可在嵌入式 Langflow 编辑器中定制,包括更换模型或组件;也支持自定义 Langflow 组件和 MCP 服务器。
- 文档导入。文件来自本地文件系统,或经 OAuth 授权的云存储连接器;由 Docling Serve 解析并切分。
- 搜索。OpenSearch 存储文档和嵌入向量,并提供混合搜索与多租户支持。
- SDK 与 API。官方 Python 和 TypeScript SDK 以 openrag-sdk 发布,文档中还有 API 参考。
- 可观测性。向 Langfuse 的追踪和 IBM Instana 追踪器均为可选,默认关闭。
数据流向与访问控制
按文档所述,Docling Serve 在本地处理你的文档,OpenSearch 把它们存入你自己的知识库;云端数据只通过你授权的连接器加载。整体架构由容器组成:后端、Langflow、Docling Serve、连接器和前端。
默认的模型提供商是 OpenAI,使用它时,你的提示词和检索到的文档片段会按 OpenAI 自身的政策发往 OpenAI。配置参考还列出了 Anthropic、Ollama 和 IBM watsonx.ai,因此也可以改为指向本地的 Ollama 端点。如果没有设置 Langflow 超级用户密码,Langflow 会在无身份验证的状态下启动,这正是文档建议设置密码的原因。
📌注: 关于本地处理的说法是项目自己的描述;PromptQuorum 没有审计容器及其网络流量。除非更改镜像仓库,终端的升级检查会查询 Docker Hub API。
适合哪些人
- 想要现成 RAG 套件的开发者,不必自己拼装 Langflow、OpenSearch 和 Docling。
- 已在运行容器的团队,希望对自己的文件使用带多租户的混合搜索。
- 需要 API 或 SDK 的开发者,想在自己的应用里调用文档检索智能体。
我们未能核实的内容
- 实际表现。PromptQuorum 没有运行该软件,因此回答质量、引用准确度、导入速度和稳定性均未评估。
- 遥测。所查页面没有记录容器的数据分析情况,也没有关闭选项。
- 隐私政策。没有找到 OpenRAG 专属的隐私政策页面;文档只引用了 IBM 的通用隐私声明。
- 纯本地运行。文档介绍了对 Ollama 的支持,但快速入门只以 OpenAI 为例,完全离线的配置尚未测试。
竞品与替代方案
Langflow
- 平台:
- Web
- 价格 / 许可证:
- 免费 / MIT
- 主要区别:
- OpenRAG 所嵌入的可视化流程构建器,不含配套的搜索套件
关于Langflow的文章(3篇)
- Langflow Review: The IBM-Owned Alternative to Flowise更新于 2026年9月2日
- Local Coding Assistants, Agents & Workflow Tools Compared (2026): IDE Plugins, Agent Frameworks and Autonomous Agents更新于 2026年9月21日
- Local Knowledge & Retrieval Tools Compared (2026): RAG, Document Chat, Vector Databases, Notes and Search更新于 2026年9月20日
其他提及:
RAGFlow
- 平台:
- Linux、Web
- 价格 / 许可证:
- 免费 / Apache 2.0
- 主要区别:
- 以深度文档理解和引用为核心的 RAG 引擎
关于RAGFlow的文章(5篇)
- RAGFlow Review: Citation-Grade RAG for Complex Documents更新于 2026年9月2日
- Local Knowledge & Retrieval Tools Compared (2026): RAG, Document Chat, Vector Databases, Notes and Search更新于 2026年9月20日
- Langchain-Chatchat Review: Self-Hosted RAG and Agent Framework更新于 2026年9月18日
- MaxKB Review: Self-Hosted RAG Platform for DeepSeek and Qwen更新于 2026年9月12日
- Best RAG Tools for Business Documents 2026: Local & Private AI Compared更新于 2026年8月26日
其他提及:
AnythingLLM
- 平台:
- Windows、macOS、Linux、Web
- 价格 / 许可证:
- 免费 / MIT
- 主要区别:
- 可安装的桌面应用,内置向量库,无需容器
关于AnythingLLM的文章(10篇)
- AnythingLLM Review: Open-Source RAG and Document Chat更新于 2026年9月11日
- Best Local LLM Frontends & Chat UIs in 2026: Open WebUI, Enchanted UI, and More更新于 2026年10月31日
- Best Local LLM Apps for Mac in 2026: LM Studio, Ollama, Jan and 5 More更新于 2026年10月31日
- Local LLM App Alternatives in 2026: Options to LM Studio, Ollama, Open WebUI and PocketPal AI更新于 2026年10月31日
- Best Local AI App for Non-Technical Users (2026)更新于 2026年10月28日
- AnythingLLM vs PrivateGPT vs Open WebUI: Best Local RAG in 2026更新于 2026年10月16日
- Open WebUI in 2026: The Self-Hosted ChatGPT Interface for Ollama and Any AI Model更新于 2026年10月9日
- Cherry Studio 2.0 in 2026: The Free Agent-Based AI Desktop App更新于 2026年9月20日
- Local Chat Apps & Assistants Compared (2026): Desktop, Mobile, Self-Hosted, Assistants and Roleplay更新于 2026年9月20日
- Local Knowledge & Retrieval Tools Compared (2026): RAG, Document Chat, Vector Databases, Notes and Search更新于 2026年9月20日
另有31篇未显示
Dify
- 平台:
- Web、Linux
- 价格 / 许可证:
- 免费增值 / 修改版 Apache 2.0
- 主要区别:
- 更广泛的 AI 工作流与智能体构建器,RAG 只是其中一部分
关于Dify的文章(8篇)
- Dify Review: Open-Source LLMOps Platform vs. LangChain, Flowise更新于 2026年10月30日
- Local Coding Assistants, Agents & Workflow Tools Compared (2026): IDE Plugins, Agent Frameworks and Autonomous Agents更新于 2026年9月21日
- Local Knowledge & Retrieval Tools Compared (2026): RAG, Document Chat, Vector Databases, Notes and Search更新于 2026年9月20日
- MaxKB Review: Self-Hosted RAG Platform for DeepSeek and Qwen更新于 2026年9月12日
- Enterprise Chatbot Deployment with Local LLMs: Internal Helpdesk & HR Bots (2026)更新于 2026年9月3日
- h2oGPT Review: Features, Setup, and Why the Project Is Archived更新于 2026年9月3日
- RAGFlow Review: Citation-Grade RAG for Complex Documents更新于 2026年9月2日
- Best RAG Tools for Business Documents 2026: Local & Private AI Compared更新于 2026年8月26日
其他提及:
- Snug Protocol: Portable, AI-Built Personal Apps, Explained更新于 2026年10月18日
- AutoGPT Review: Classic Agent vs. Hosted Platform更新于 2026年9月20日
另有3篇未显示
竞品信息变化较快;请在各应用自己的页面上确认当前价格、许可证和平台。
常见问题
OpenRAG 推荐哪些 Ollama 模型?
文档建议语言模型用 gpt-oss:20b 或 mistral-nemo:12b,嵌入模型用 nomic-embed-text、mxbai-embed-large 或 embeddinggemma。聊天模型必须支持工具调用,文档也不保证每个 Ollama 模型都能正常工作。
它使用哪些端口?
默认情况下,前端 3000,Langflow 7860,后端 8000,OpenSearch 9200,OpenSearch Dashboards 5601,Docling 5001。前端和 Langflow 的端口可以在 .env 文件中修改。
它能从哪些云存储导入数据?
配置参考介绍了经 Google OAuth 的 Google Drive、经 Microsoft Graph 应用注册的 SharePoint 与 OneDrive,以及使用访问密钥的 AWS S3。
如何在自己的代码里调用它?
用 pip install openrag-sdk 安装 Python SDK,或用 npm install openrag-sdk 安装 TypeScript SDK。较早的独立包 openrag-mcp 已被弃用。
结论
OpenRAG 是一套免费的 Apache-2.0 RAG 方案,按其文档,Langflow、OpenSearch 和 Docling 已预先连通,并且维护活跃:2026 年 10 月初有新版本发布,10 月 23 日仍有更新。另一方面,它运行较重,Windows 只能通过 WSL,默认使用 OpenAI,PromptQuorum 也无法核实它的质量、遥测情况和完全离线使用。它适合想要现成、可深度修改的 RAG 后端的开发者;偏好可安装应用的读者可以对比 AnythingLLM,只需要流程构建器的读者可以看看 Langflow。
来源
- OpenRAG 文档 — 概览、快速入门、安装选项、故障排查和配置参考,2026 年 10 月 23 日核对。
- OpenRAG 官网 — 项目主页。
- GitHub 上的 OpenRAG及其 v0.8.0 版本 — 源代码、Apache-2.0 许可证和发布文件。
