R2R

一键部署生产级智能检索,让 RAG 应用开箱即用

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 653 🐛 待处理 132 👀 关注 44
GitHub ↗
GitHub 星标 ★ 8075
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,可自行部署,完全免费。

项目预览

R2R 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队SciPhi-AI
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,可自行部署,完全免费。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型artificial-intelligence,large-language-models,python,question-answering,rag,retrieval-augmented-generation,retrieval-systems,search
GitHub 星标★ 8075
上线时间2024-02-12 00:00:00
代码更新2025-11-07
仓库体积63.8 MB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数2

项目介绍

R2R 是一个面向生产环境的 AI 检索系统,专注于智能体检索增强生成(Agentic RAG)。它解决了传统 RAG 系统在部署和集成上的痛点,将文档摄取、分块、嵌入、向量存储、重排序、检索和生成等全流程封装为统一的 RESTful API,并支持多模态数据(文本、图像、音频等)的解析与检索。核心能力包括:端到端的 RAG 流水线编排、基于知识图谱的混合搜索(关键词+向量)、可配置的评估与优化机制、以及支持多智能体协作的 Agentic RAG 功能。系统采用模块化设计,支持自定义嵌入模型、向量数据库和重排序器,并提供了 Python 和 TypeScript 客户端 SDK,方便开发者快速集成。其目标是成为生产级 RAG 应用的事实标准,降低企业构建智能搜索和问答系统的门槛。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 8075

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:本地安装 4 步

环境要求

  • Python 环境(可通过 pip 安装 r2r)
  • OpenAI API Key,配置到环境变量 OPENAI_API_KEY
  • 使用全模式需安装 Docker 与 Docker Compose
  • 全模式需要本地存在 compose.full.yaml 文件

安装与启动步骤

  1. 1安装 R2R

    通过 pip 安装 R2R 包,这是 README 给出的 quick install 方式。

    pip install r2r
  2. 2配置 API 密钥

    设置 OPENAI_API_KEY 环境变量;示例中的 sk-... 需换成你自己的真实密钥。

    export OPENAI_API_KEY=sk-...
  3. 3启动轻量服务

    以 light 模式启动 R2R 服务,执行后保持终端运行以查看日志。

    python -m r2r.serve
  4. 4全模式 Docker 启动

    用 compose.full.yaml 的 postgres profile 启动完整模式,需在该文件所在目录执行。

    docker compose -f compose.full.yaml --profile postgres up -d

关键配置

配置项必填说明示例
OPENAI_API_KEY是OpenAI 接口密钥,供模型调用使用sk-xxxxxxxxxxxxxxxx

如何确认成功

执行 python -m r2r.serve 后终端持续输出服务日志且无报错;Docker 模式下容器保持运行即为成功。

常见问题

Q:不用 OpenAI 可以吗?

A:README 只示范了 OPENAI_API_KEY,其他模型与嵌入方案未给出,需查阅官方 self-hosting 文档。

Q:light 模式和 full 模式有什么区别?

A:README 仅说明 light 模式用 pip 直接运行、full 模式用 Docker 加 postgres profile,细节见官方自托管文档。

Q:服务监听哪个端口?

A:README 未给出默认端口或访问地址,请参考官方 self-hosting 文档确认。

Q:TypeScript SDK 怎么安装?

A:README 只给出 Python SDK 的 pip install r2r,未提供 TS 安装命令。

注意事项

  • README 未写明默认端口、数据目录等参数,细节请查阅官方 self-hosting 文档。
  • API Key 属敏感信息,不要写入代码或提交到 Git 仓库。
  • 全模式依赖 Docker 与 compose.full.yaml,请确认文件存在再执行命令。

核心亮点

  • 提供完整的 RESTful API,后端集成简单,前端可快速调用
  • 内置多模态数据解析(文本/图像/音频),扩展了检索范围
  • 支持知识图谱与混合搜索,检索精度高于纯向量方案

不足之处

  • 项目较新,文档和社区生态仍在完善中
  • 高级功能(如多智能体协作)配置复杂度较高,学习曲线陡峭

适用场景

  • 企业知识库智能问答系统
  • 多模态内容检索(如文档、图片、音频混合搜索)
  • 需要快速搭建生产级 RAG 服务的开发团队

替代项目

LangChain、LlamaIndex、Haystack

上一篇:deep-searcher

下一篇:vespa

同类项目推荐

kensaku 开源

本地搜文档、代码和截图,还能给 AI 代理调用

Search inside documents, code, and even screenshots - instantly and locally. A free,···

★ 1503 2026-10-30
langconnect 开源

上传文档即得问答 API,省去自建 RAG 管道

A managed RAG API server.

★ 345 2026-09-12
LLM-Document-Chat 开源

用 LlamaIndex 和 Redis 让 PDF 开口说话,直接提问文档内容。

Using LlamaIndex, Redis, and OpenAI to chat with PDF documents. Supplementary materi···

★ 113 2026-08-09
vespa 开源

用 AI 搜索平台,构建实时推荐与语义检索应用

The AI search platform

★ 7165 2026-08-09
statespace 开源

让AI代理快速搜到想要的网页结果

A/B test code changes on your own infrastructure

★ 1 2026-08-09
swirl-search 开源

数据不用搬家,100多个应用里的资料随问随到

AI Search & RAG Without Moving Your Data. Get instant answers from your company's kn···

★ 3049 2026-08-09
coding_agent_session_search 开源

一个终端工具,搜遍所有 AI 编码助手的聊天记录。

Unified TUI and CLI to index and search your local coding agent session history acro···

★ 1202 2026-08-09
memex 开源

一句话搜回所有 AI 编程会话,还能续聊和算 token

Search Claude Code, Codex, Pi, OpenCode, Github Copilot & Cursor transcripts. Resume···

★ 309 2026-09-12
feeds.fun 开源

用标签和 AI 评分,让新闻阅读更聪明

News reader with tags, scoring, and LLM

★ 397 2026-08-09