百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术资源 > 正文

在Windows环境下,本地部署和启动开源项目Ragflow的源代码

off999 2025-03-28 20:16 30 浏览 0 评论

在当前AI领域中,基于检索增强生成(RAG)的应用备受关注,而开源项目RAGFlow因其灵活性和功能性成为了一个热门选择。不过,由于其快速的版本迭代,可能会存在一些Bug,并且在实际项目落地时通常需要根据具体需求对源码进行定制化修改。遗憾的是,RAGFlow官方尚未提供针对Windows开发环境的详细文档。因此,在本地部署过程中,我整理了一份详细的记录,希望能够为有类似需求的开发者提供参考。

一、RAGFlow Python 环境配置

确保您的Python版本符合以下要求:

  • Python 版本:>=3.10,<3.13

二、Poetry 下载与安装

使用 Poetry 来管理 Python 依赖。首先,通过 pip 安装 Poetry:

pip install poetry

验证安装是否成功:

poetry --version

三、安装 Python 依赖

  1. 以管理员身份启动 Anaconda Prompt
  2. 为了确保权限足够,建议以管理员身份启动 Anaconda Prompt。

2、切换到ragflow运行环境

(base) C:\Windows\System32>D:
(base) D:>conda activate ragflow
(ragflow) D:>cd D:\WorkSpace\ForAi\pythod\ragflow

3、在ragflow根目录下运行poetry安装依赖命令

# 安装所有默认依赖
poetry install

# 安装 full 组中的依赖
poetry install -E full

4、已知问题与后续处理

在安装过程中,pyicu 版本 ==2.14 未能成功安装。目前这一问题对解析文档和聊天功能没有影响,因此暂时未进行处理。后续将更新文档以记录具体的解决方法。

四、前端启动

1、前端web服务器nginx

默认在目录下提供的配置文件是linux的,需要改成windows

nginx.conf

# user 指令在 Windows 上不支持,注释掉或删除
# user  root;

worker_processes  auto;

# 修改日志路径为 Windows 路径
error_log  D:/dockerData/ragflow/nginx-1.21.1/logs/error.log notice;
pid        D:/dockerData/ragflow/nginx-1.21.1/logs/nginx.pid;

events {
    worker_connections  1024;
}

http {
    # 修改 mime.types 文件路径为 Windows 路径
    include       D:/dockerData/ragflow/nginx-1.21.1/conf/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    # 修改访问日志路径为 Windows 路径
    access_log  D:/dockerData/ragflow/nginx-1.21.1/logs/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    keepalive_timeout  65;

    #gzip  on;
    client_max_body_size 128M;

    # 包含自定义配置文件
    include D:/dockerData/ragflow/nginx-1.21.1/conf/ragflow.conf;
}

proxy.conf

这个配置文件不做修改

ragflow.conf

server {
    listen 80;
    server_name _;
    # 设置根目录为 Windows 路径
    root D:/WorkSpace/ForAi/pythod/ragflow/web/dist;

    gzip on;
    gzip_min_length 1k;
    gzip_comp_level 9;
    gzip_types text/plain application/javascript application/x-javascript text/css application/xml text/javascript application/x-httpd-php image/jpeg image/gif image/png;
    gzip_vary on;
    gzip_disable "MSIE [1-6]\.";

    location ~ ^/(v1|api) {
        proxy_pass http://127.0.0.1:9380;
        include proxy.conf;
    }


    location / {
        index index.html;
        try_files $uri $uri/ /index.html;
    }

    # Cache-Control: max-age~@~AExpires
    location ~ ^/static/(css|js|media)/ {
        expires 10y;
        access_log off;
    }
}

2、前端项目build

我使用的nodejs版本是 20.15.0 如果你本地有多个nodejs版本可以使用nvm管理切换

# 进入web目录下
(ragflow) D:\WorkSpace\ForAi\pythod\ragflow>cd web
# 安装前端依赖
npm install
# build项目
npm run build

可以看到web目录下多了个dist,ragflow.conf配置文件里需要配置这个目录

3、启动nginx

D:\dockerData\ragflow\nginx-1.21.1>start nginx

五、下载模型

找到根目录下的download_deps.py直接运行

依赖安装会比较慢

运行完根目录下多了这些文件

六、后端项目启动

1、配置mysql、redis、minio、es、infinity

2、启动项目

需要启动两个文件

(1)api下的ragflow_server.py

(2)rag/svr下的task_executor.py

在启动时遇到了文件是utf-8格式,默认使用的是gbk,我处理方式是直接改了源码,把文件处理的格式改成了utf-8

import os
import json
current_file_path = os.path.dirname(os.path.abspath(__file__))
json_file_path = os.path.join(current_file_path, "res/good_sch.json")

with open(json_file_path, "r", encoding="utf-8") as file:
    GOOD_SCH = json.load(file)

import os
import json

current_file_path = os.path.dirname(os.path.abspath(__file__))

# 读取 corp.tks.freq.json 文件
with open(os.path.join(current_file_path, "res/corp.tks.freq.json"), "r", encoding="utf-8") as file:
    CORP_TKS = json.load(file)

# 读取 good_corp.json 文件
with open(os.path.join(current_file_path, "res/good_corp.json"), "r", encoding="utf-8") as file:
    GOOD_CORP = json.load(file)

# 读取 corp_tag.json 文件
with open(os.path.join(current_file_path, "res/corp_tag.json"), "r", encoding="utf-8") as file:
    CORP_TAG = json.load(file)

cnvs = json.load(open(os.path.join(dir, fnm), "r", encoding="utf-8"))

七、以上步骤做完即可通过http://127.0.0.1访问

相关推荐

使用 python-fire 快速构建 CLI_如何搭建python项目架构

命令行应用程序是开发人员最好的朋友。想快速完成某事?只需敲击几下键盘,您就已经拥有了想要的东西。Python是许多开发人员在需要快速组合某些东西时选择的第一语言。但是我们拼凑起来的东西在大多数时候并...

Python 闭包:从底层逻辑到实战避坑,附安全防护指南

一、闭包到底是什么?你可以把闭包理解成一个"带记忆的函数"。它诞生时会悄悄记下自己周围的变量,哪怕跑到别的地方执行,这些"记忆"也不会丢失。就像有人出门时总会带上...

使用Python实现九九乘法表的打印_用python打印一个九九乘法表

任务要求九九乘法表的结构如下:1×1=11×2=22×2=41×3=32×3=63×3=9...1×9=92×9=18...9×9=81使用Python编写程序,按照上述格式打印出完整的九...

吊打面试官(四)--Java语法基础运算符一文全掌握

简介本文介绍了Java运算符相关知识,包含运算规则,运算符使用经验,特殊运算符注意事项等,全文5400字。熟悉了这些内容,在运算符这块就可以吊打面试官了。Java运算符的规则与特性1.贪心规则(Ma...

Python三目运算基础与进阶_python三目运算符判断三个变量

#头条创作挑战赛#Python中你学会了三步运算,你将会省去很多无用的代码,我接下来由基础到进阶的方式讲解Python三目运算基础在Python中,三目运算符也称为条件表达式。它可以通过一行代码实现条...

Python 中 必须掌握的 20 个核心函数——set()详解

set()是Python中用于创建集合的核心函数,集合是一种无序、不重复元素的容器,非常适合用于成员检测、去重和数学集合运算。一、set()的基本用法1.1创建空集合#创建空集合empty_se...

15个让Python编码效率翻倍的实用技巧

在软件开发领域,代码质量往往比代码数量更重要。本文整理的15个Python编码技巧,源自开发者在真实项目中验证过的工作方法,能够帮助您用更简洁的代码实现更清晰的逻辑。这些技巧覆盖基础语法优化到高级特性...

《Python从小白到入门》自学课程目录汇总(和猫妹学Python)

小朋友们好,大朋友们好!不知不觉,这套猫妹自学Python基础课程已经结束了,猫妹体会到了水滴石穿的力量。水一直向下滴,时间长了能把石头滴穿。只要坚持不懈,细微之力也能做出很难办的事。就比如咱们的学习...

8÷2(2+2) 等于1还是16?国外网友为这道小学数学题吵疯了……

近日,国外网友因为一道小学数学题在推特上争得热火朝天。事情的起因是一个推特网友@pjmdoll发布了一条推文,让他的关注者解答一道数学题:Viralmathequationshavebeen...

Python学不会来打我(21)python表达式知识点汇总

在Python中,表达式是由变量、运算符、函数调用等组合而成的语句,用于产生值或执行特定操作。以下是对Python中常见表达式的详细讲解:1.1算术表达式涉及数学运算的表达式。例如:a=5b...

Python运算符:数学助手,轻松拿咧

Python中的运算符就像是生活中的数学助手,帮助我们快速准确地完成这些计算。比如购物时计算总价、做家务时分配任务等。这篇文章就来详细聊聊Python中的各种运算符,并通过实际代码示例帮助你更好地理解...

Python学不会来打我(17)逻辑运算符的使用方法与使用场景

在Python编程中,逻辑运算符(LogicalOperators)是用于组合多个条件表达式的关键工具。它们可以将多个布尔表达式连接起来,形成更复杂的判断逻辑,并返回一个布尔值(True或Fa...

Python编程基础:运算符的优先级_python中的运算符优先级问题

多个运算符同时出现在一个表达式中时,先执行哪个,后执行哪个,这就涉及运算符的优先级。如数学表达式,有+、-、×、÷、()等,优先级顺序是()、×、÷、+、-,如5+(5-3)×4÷2,先计算(5-3)...

Python运算符与表达式_python中运算符&的功能

一、运算符分类总览1.Python运算符全景图2.运算符优先级表表1.3.1Python运算符优先级(从高到低)优先级运算符描述结合性1**指数右→左2~+-位非/一元加减右→左3*//...

Python操作Excel:从基础到高级的深度实践

Python凭借其丰富的库生态系统,已成为自动化处理Excel数据的强大工具。本文将深入探讨五个关键领域,通过实际代码示例展示如何利用Python进行高效的Excel操作,涵盖数据处理、格式控制、可视...

取消回复欢迎 发表评论: