在 macOS 上从源码部署 RAGFlow-0.14.1：详细指南

一、引言

RAGFlow 作为一款强大的工具，在人工智能领域应用广泛。本文将详细介绍如何在 macOS 系统上从源码部署 RAGFlow 0.14.1 版本，无论是开发人员进行项目实践，还是技术爱好者探索新工具，都能从这篇指南中获取清晰、实用的部署步骤。

二、部署前准备

（一）系统配置检查
本次部署以配备 Apple M3 Pro 芯片、18GB 内存且运行 Sonoma 14.6.1 系统的 MacBook Pro 为例。在部署前，需确认你的设备配置与之相当或更优，以确保部署过程顺利及后续使用体验。
（二）安装 Docker 和 Docker Compose
版本要求：RAGFlow 官方明确规定，部署所需的 Docker 版本需大于等于 24.0.0，Docker Compose 版本需大于等于 v2.26.1。
安装与检查：若尚未安装，前往 Docker 官方网站下载并安装对应版本。安装完成后，在终端分别输入以下命令检查版本：

docker -v
docker-compose --version

若已安装但版本不满足要求，需及时更新到指定版本。若显示的版本符合要求，则可继续后续步骤。
三、安装和配置 RAGFlow 的前后端
（一）下载项目
打开终端，进入你期望安装 RAGFlow 的目录，执行以下命令克隆项目仓库：

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

这一步将把 RAGFlow 项目的源代码下载到本地指定目录，并进入该项目目录，为后续安装和配置做准备。
（二）安装 Python 依赖项
安装 Poetry：Poetry 是 Python 项目依赖管理的重要工具，在终端执行以下命令进行安装：

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

安装完成后，使用poetry --version检查版本。若出现zsh: command not found: poetry错误，这是因为 Poetry 的安装目录未被添加到系统环境变量PATH中。此时，需编辑~/.zshrc文件，在文件末尾添加（注意将kuangfh替换为你的用户名）：

export PATH="/Users/kuangfh/.local/bin: