Skip to content

Latest commit

 

History

History
340 lines (246 loc) · 13.2 KB

README_zh.md

File metadata and controls

340 lines (246 loc) · 13.2 KB
Raw

English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia

follow on X(Twitter) Static Badge docker pull infiniflow/ragflow:v0.14.1 Latest Release license

Document | Roadmap | Twitter | Discord | Demo

💡 RAGFlow 是什么？

RAGFlow 是一款基于深度文档理解构建的开源 RAG（Retrieval-Augmented Generation）引擎。RAGFlow 可以为各种规模的企业及个人提供一套精简的 RAG 工作流程，结合大语言模型（LLM）针对用户各类不同的复杂格式数据提供可靠的问答以及有理有据的引用。

🎮 Demo 试用

请登录网址 https://demo.ragflow.io 试用 demo。

🔥 近期更新

  • 2024-11-22 完善了 Agent 中的变量定义和使用。
  • 2024-11-01 对解析后的 chunk 加入关键词抽取和相关问题生成以提高召回的准确度。
  • 2024-09-13 增加知识库问答搜索模式。
  • 2024-08-22 支持用 RAG 技术实现从自然语言到 SQL 语句的转换。
  • 2024-08-02 支持 GraphRAG 启发于 graphrag 和思维导图。

🎉 关注项目

⭐️点击右上角的 Star 关注RAGFlow，可以获取最新发布的实时通知 !🌟

🌟 主要功能

🍭 "Quality in, quality out"

  • 基于深度文档理解，能够从各类复杂格式的非结构化数据中提取真知灼见。
  • 真正在无限上下文（token）的场景下快速完成大海捞针测试。

🍱 基于模板的文本切片

  • 不仅仅是智能，更重要的是可控可解释。
  • 多种文本模板可供选择

🌱 有理有据、最大程度降低幻觉（hallucination）

  • 文本切片过程可视化，支持手动调整。
  • 有理有据：答案提供关键引用的快照并支持追根溯源。

🍔 兼容各类异构数据源

  • 支持丰富的文件类型，包括 Word 文档、PPT、excel 表格、txt 文件、图片、PDF、影印件、复印件、结构化数据、网页等。

🛀 全程无忧、自动化的 RAG 工作流

  • 全面优化的 RAG 工作流可以支持从个人应用乃至超大型企业的各类生态系统。
  • 大语言模型 LLM 以及向量模型均支持配置。
  • 基于多路召回、融合重排序。
  • 提供易用的 API，可以轻松集成到各类企业系统。

🔎 系统架构

🎬 快速开始

📝 前提条件

  • CPU >= 4 核
  • RAM >= 16 GB
  • Disk >= 50 GB
  • Docker >= 24.0.0 & Docker Compose >= v2.26.1

    如果你并没有在本机安装 Docker（Windows、Mac，或者 Linux）, 可以参考文档 Install Docker Engine 自行安装。

🚀 启动服务器

  1. 确保 vm.max_map_count 不小于 262144：

    如需确认 vm.max_map_count 的大小：

    $ sysctl vm.max_map_count

    如果 vm.max_map_count 的值小于 262144，可以进行重置：

    # 这里我们设为 262144:
$ sudo sysctl -w vm.max_map_count=262144

    你的改动会在下次系统重启时被重置。如果希望做永久改动，还需要在 /etc/sysctl.conf 文件里把 vm.max_map_count 的值再相应更新一遍：

    vm.max_map_count=262144

  2. 克隆仓库：

    $ git clone https://github.com/infiniflow/ragflow.git

  3. 进入 docker 文件夹，利用提前编译好的 Docker 镜像启动服务器：

    运行以下命令会自动下载 dev 版的 RAGFlow slim Docker 镜像（dev-slim），该镜像并不包含 embedding 模型以及一些 Python 库，因此镜像大小约 1GB。

    $ cd ragflow/docker
$ docker compose -f docker-compose.yml up -d
    • 如果你想下载并运行特定版本的 RAGFlow slim Docker 镜像，请在 docker/.env 文件中找到 RAGFLOW_IMAGE 变量，将其改为对应版本。例如 RAGFLOW_IMAGE=infiniflow/ragflow:v0.14.1-slim，然后再运行上述命令。
    • 如果您想安装内置 embedding 模型和 Python 库的 dev 版本的 Docker 镜像，需要将 docker/.env 文件中的 RAGFLOW_IMAGE 变量修改为： RAGFLOW_IMAGE=infiniflow/ragflow:dev。
    • 如果您想安装内置 embedding 模型和 Python 库的指定版本的 RAGFlow Docker 镜像，需要将 docker/.env 文件中的 RAGFLOW_IMAGE 变量修改为： RAGFLOW_IMAGE=infiniflow/ragflow:v0.14.1。修改后，再运行上面的命令。 注意： 安装内置 embedding 模型和 Python 库的指定版本的 RAGFlow Docker 镜像大小约 9 GB，可能需要更长时间下载，请耐心等待。

  4. 服务器启动成功后再次确认服务器状态：

    $ docker logs -f ragflow-server

    出现以下界面提示说明服务器启动成功：

         ____   ___    ______ ______ __               
    / __ \ /   |  / ____// ____// /____  _      __
   / /_/ // /| | / / __ / /_   / // __ \| | /| / /
  / _, _// ___ |/ /_/ // __/  / // /_/ /| |/ |/ / 
 /_/ |_|/_/  |_|\____//_/    /_/ \____/ |__/|__/  

 * Running on all addresses (0.0.0.0)
 * Running on http://127.0.0.1:9380
 * Running on http://x.x.x.x:9380
 INFO:werkzeug:Press CTRL+C to quit

    如果您跳过这一步系统确认步骤就登录 RAGFlow，你的浏览器有可能会提示 network anormal 或 网络异常，因为 RAGFlow 可能并未完全启动成功。

  5. 在你的浏览器中输入你的服务器对应的 IP 地址并登录 RAGFlow。

    上面这个例子中，您只需输入 http://IP_OF_YOUR_MACHINE 即可：未改动过配置则无需输入端口（默认的 HTTP 服务端口 80）。

  6. 在 service_conf.yaml 文件的 user_default_llm 栏配置 LLM factory，并在 API_KEY 栏填写和你选择的大模型相对应的 API key。

    详见 llm_api_key_setup。

    好戏开始，接着奏乐接着舞！

🔧 系统配置

系统配置涉及以下三份文件：

  • .env：存放一些基本的系统环境变量，比如 SVR_HTTP_PORT、MYSQL_PASSWORD、MINIO_PASSWORD 等。
  • service_conf.yaml：配置各类后台服务。
  • docker-compose.yml: 系统依赖该文件完成启动。

请务必确保 .env 文件中的变量设置与 service_conf.yaml 文件中的配置保持一致！

如果不能访问镜像站点hub.docker.com或者模型站点huggingface.co，请按照.env注释修改RAGFLOW_IMAGE和HF_ENDPOINT。

./docker/README 文件提供了环境变量设置和服务配置的详细信息。请一定要确保 ./docker/README 文件当中列出来的环境变量的值与 service_conf.yaml 文件当中的系统配置保持一致。

如需更新默认的 HTTP 服务端口(80), 可以在 docker-compose.yml 文件中将配置 80:80 改为 <YOUR_SERVING_PORT>:80。

所有系统配置都需要通过系统重启生效：

$ docker compose -f docker-compose.yml up -d

把文档引擎从 Elasticsearch 切换成为 Infinity

RAGFlow 默认使用 Elasticsearch 存储文本和向量数据. 如果要切换为 Infinity, 可以按照下面步骤进行:

  1. 停止所有容器运行:

    $ docker compose -f docker/docker-compose.yml down -v

  2. 设置 docker/.env 目录中的 DOC_ENGINE 为 infinity.

  3. 启动容器:

    $ docker compose -f docker/docker-compose.yml up -d

Warning

Infinity 目前官方并未正式支持在 Linux/arm64 架构下的机器上运行.

🔧 源码编译 Docker 镜像（不含 embedding 模型）

本 Docker 镜像大小约 1 GB 左右并且依赖外部的大模型和 embedding 服务。

git clone https://github.com/infiniflow/ragflow.git
cd ragflow/
pip3 install huggingface-hub nltk
python3 download_deps.py
docker build -f Dockerfile.slim -t infiniflow/ragflow:dev-slim .

🔧 源码编译 Docker 镜像（包含 embedding 模型）

本 Docker 大小约 9 GB 左右。由于已包含 embedding 模型，所以只需依赖外部的大模型服务即可。

git clone https://github.com/infiniflow/ragflow.git
cd ragflow/
pip3 install huggingface-hub nltk
python3 download_deps.py
docker build -f Dockerfile -t infiniflow/ragflow:dev .

🔨 以源代码启动服务

  1. 安装 Poetry。如已经安装，可跳过本步骤：

    curl -sSL https://install.python-poetry.org | python3 -

  2. 下载源代码并安装 Python 依赖：

    git clone https://github.com/infiniflow/ragflow.git
cd ragflow/
export POETRY_VIRTUALENVS_CREATE=true POETRY_VIRTUALENVS_IN_PROJECT=true
~/.local/bin/poetry install --sync --no-root # install RAGFlow dependent python modules

  3. 通过 Docker Compose 启动依赖的服务（MinIO, Elasticsearch, Redis, and MySQL）：

    docker compose -f docker/docker-compose-base.yml up -d

    在 /etc/hosts 中添加以下代码，将 docker/service_conf.yaml 文件中的所有 host 地址都解析为 127.0.0.1：

    127.0.0.1       es01 infinity mysql minio redis

    在文件 docker/service_conf.yaml 中，对照 docker/.env 的配置将 mysql 端口更新为 5455，es 端口更新为 1200。

  4. 如果无法访问 HuggingFace，可以把环境变量 HF_ENDPOINT 设成相应的镜像站点：

    export HF_ENDPOINT=https://hf-mirror.com

  5. 启动后端服务：

    source .venv/bin/activate
export PYTHONPATH=$(pwd)
bash docker/launch_backend_service.sh

  6. 安装前端依赖：

    cd web
npm install --force

  7. 启动前端服务：

    npm run dev

    以下界面说明系统已经成功启动：

📚 技术文档

📜 路线图

详见 RAGFlow Roadmap 2024 。

🏄 开源社区

🙌 贡献指南

RAGFlow 只有通过开源协作才能蓬勃发展。秉持这一精神,我们欢迎来自社区的各种贡献。如果您有意参与其中,请查阅我们的 贡献者指南 。

🤝 商务合作

👥 加入社区

扫二维码添加 InfinifFlow 小助手，进 RAGFlow 交流群。