在任何企业中使用代理式 RAG 的最简单方式。

配置起来就像 OpenAI 的自定义 GPT 一样简单，但可以使用 Docker 部署在您自己的云基础设施中。基于 LlamaIndex 构建。

开始使用 · 端点 · 部署 · 联系我们

开始使用

要运行，请使用我们的镜像启动一个 Docker 容器：

docker run -p 8000:8000 ragapp/ragapp

然后，访问 http://localhost:8000/admin 中的管理界面来配置您的 RAGapp。

您可以使用 OpenAI 或 Gemini 的托管 AI 模型，也可以使用 Ollama 提供的本地模型。

注意: 为了避免 遇到任何错误，我们建议使用最新版本的 Docker 和（如果需要）Docker Compose。

端点

Docker 容器暴露以下端点：

• 管理界面：http://localhost:8000/admin
• 聊天界面：http://localhost:8000
• API：http://localhost:8000/docs

注意: 聊天界面和 API 只有在 RAGapp 已经配置的情况下才会正常工作。

安全性

认证

RAGapp 容器本身默认不包含任何认证层。这部分功能应由将流量路由到 RAGapp 的 API 网关来实现。这一步骤高度依赖于您的云服务提供商以及所使用的具体服务。对于纯 Docker Compose 环境，您可以参考我们的 带有管理界面的 RAGapp 部署方案。

授权

RAGapp 的后续版本将支持根据从 API 网关或其他类似系统传递而来的访问令牌来限制访问权限。

部署

使用 Docker Compose

您可以通过以下几种 Docker Compose 部署方式轻松地将 RAGapp 部署到您自己的基础设施中：

1. 带有 Ollama 和 Qdrant 的 RAGapp
2. 多个带有管理界面的 RAGapp

Kubernetes

在您自己的云基础设施中部署 RAGapp 也非常容易。定制化的 K8S 部署描述文件即将推出。

开发

RAGApp:

重要: 本项目的部分源代码是从 create-llama 项目动态获取的。在提交更改之前，请务必通过运行 make build-frontends 来更新源代码。

进入 src/ragapp 目录，并执行以下命令：

export ENVIRONMENT=dev
poetry install --no-root
make build-frontends
make dev

然后，访问 http://localhost:3000/admin 即可查看管理界面。

注意: 请确保已安装 Poetry。

联系我们

有任何问题、功能需求或发现 bug 吗？请 新建一个 issue 或联系 marcusschiesser。

星标历史

RAGapp 快速上手指南

RAGapp 是企业级 Agentic RAG（代理检索增强生成）的最简解决方案。它拥有类似 OpenAI 自定义 GPT 的简易配置体验，同时支持通过 Docker 部署在私有云基础设施中。本项目基于 LlamaIndex 构建。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux、macOS 或 Windows（需安装 WSL2）。
• Docker：必须安装最新版本的 Docker 和 Docker Compose，以避免潜在的兼容性错误。
  • 国内用户建议使用 Docker 国内镜像加速器 配置。
• 可选模型源：
  • 云端模型：需准备 OpenAI API Key 或 Google Gemini API Key。
  • 本地模型：如需在本地运行大模型，请预先安装 Ollama（国内用户可参考相关镜像站或离线安装包）。

安装步骤

使用 Docker 一键启动 RAGapp 容器：

docker run -p 8000:8000 ragapp/ragapp

提示：如果拉取镜像速度较慢，请检查是否已配置 Docker 镜像加速地址。

基本使用

1. 访问管理后台 容器启动后，在浏览器中打开以下地址进入配置界面： http://localhost:8000/admin

2. 配置 RAG 应用 在 Admin UI 中完成以下设置：

   • 选择 AI 模型提供商（OpenAI、Gemini 或通过 Ollama 连接的本地模型）。
   • 上传知识库文档或配置数据源。
   • 保存配置。

3. 开始对话 配置完成后，即可通过以下方式使用：

   • 聊天界面：访问 http://localhost:8000 进行对话测试。
   • API 调用：访问 http://localhost:8000/docs 查看 Swagger API 文档并进行集成开发。

注意：若未完成 Admin UI 中的配置，聊天界面和 API 将无法正常工作。