RagFlow本地开发环境部署

RagFlow

---

本文档为开发环境搭建,切勿用于生产

---

1. 前端构建

   1. 安装依赖，首先cd web 到前端路径下，使用npm i --force 安装前端的依赖包 (node 安装自己解决吧！)
   2. 等待依赖安装完成后，使用 npm run dev 启动，访问地址，会出现如下图
   3. 

---

2. 后段构建

   1. 依赖组件

      • MySQL

      • MiniO

      • PostgresSQ L

      • Redis

      • Elasticsearch

        以上组件自行安装，或docker启动，都可以。依据个人爱好而定

   2. 环境依赖

        - Python (个人为3.10)
      

   3. API 启动流程

      1. 替换配置文件

         1. 在 /path/to/pag_flow/conf/service_conf.yaml 中替换 MYSQL 等连接信息

      2. python依赖包安装

         1. 如果你是 x86 结构，使用 pip install -r requirements.txt
         2. 如果是arm架构， 使用 pip install -r requirements_arm.txt

      3. azure 安装

         1. 从 azure 5.0.0 后，已经开始弃用，如需使用需要单独安装，所以需要单独安装， 你也可以写在requirements.txt中，我比较懒，所以就手动安装了
            • pip install azure-storage-blob
            • pip install azure-identity
            • pip install azure-storage-file-datalake

      4. 其他python包

         1. 不知道是不是我安装依赖时网络的原因，运行时提示找不到一些包
            • pip install infinity_emb
            • pip install graspologic

      5. 乱七八糟的下载 (这一步可以先跳过)

         1. 因网络问题，有些数据集文件无法下载，所以想要运行需要手动下载文件

            • NLTK 数据集下载时因网络会出现异常

              1. Resource wordnet not found.
                   Please use the NLTK Downloader to obtain the resource:
                 
                   >>> import nltk
                   >>> nltk.download('wordnet')
                   
                   For more information see: https://www.nltk.org/data.html
                 
                   Attempted to load corpora/wordnet
                 
                   Searched in:
                     - '/Users/zhiboyuan/nltk_data'
                     - '/opt/miniconda3/envs/ragflow/nltk_data'
                     - '/opt/miniconda3/envs/ragflow/share/nltk_data'
                     - '/opt/miniconda3/envs/ragflow/lib/nltk_data'
                     - '/usr/share/nltk_data'
                     - '/usr/local/share/nltk_data'
                     - '/usr/lib/nltk_data'
                     - '/usr/local/lib/nltk_data'
                 

              2. 针对这个异常， 我是手动下载，然后在Searched in 下面的路径中随便选一个放到指定目录下

              3. 这里给出GitHub下载地址 NLTK Data GitHub

         2. 模型下载

            1. 程序会下载huggingface网站中InfiniFlow/deepdoc 下的模型保存到 rag/res/deepdoc 这里的 deepdoc 文件夹是我手动建立的
            2. Deepdoc 下的模型下载地址 deepdoc

         3. 其他

            1. 在启动过程中发现还有 BAAI/bge-large-zh-v1.5 等模型的下载，我这里重新运行了几遍程序，就没有问题了，也可以到网站下载模型，放到指定的目录下

      6. 启动

         1. 在 service_conf.yaml 中更改 http_port 为 9456
         2. 我是使用pycharm 启动的，所以直接运行这两个文件即可
            • api/ragflow_server.py
            • rag/svr/task_executor.py

      7. 登陆后界面

         1. 

         2. 

​