MinerU本地化部署教程——一款AI知识库建站的必备工具

admin管理员组

文章数量:1443017

MinerU本地化部署教程——一款AI知识库建站的必备工具

前言：来一个官方一点的介绍：MinerU是一个一站式、开源、高质量的数据提取工具，支持多种功能，如提取 PDF、markdown 等格式的内容。

MinerU可以用来做什么？

现在很多公司和个人都喜欢借助例如 MaxKB、Dify、AnythingLLM等开源平台搭建私有化知识库平台。但是私有文档很多是PDF文件，RAG索引对PDF文件的处理效果有限，特别是如果还有图片内容，识别解析度准确度会更低。所以需要使用更适合的文档类型来提高识别的准确度，例如markdown文件等。

下面是直接安装客户端的版本（备注：客户端版本会使用在线网络）。

下载minerU，客户端版本下载地址：

/

安装完成以后，可以直接上传文件进行解析。注意，这儿上传的文件，会被传输到远程的线上默认环境进行解析。

解析成功以后，本地会有输出的解析目录，如下所示。假如你用MaxKB的情况下，需要把images和full.md一起打包成zip压缩包丢给它。

举个例子，例如我使用MaxKB做知识库，把打包好的zip压缩包上传为知识库。

过程此处省略，直接看最终的测试效果，可以自动匹配相关内容，以及关联的图片输出。

但是使用客户端的minerU,毕竟文档会被上传到云端，如果遇到私密的文档，还可能存在消息泄露的隐患。所以需要本地化部署minerU来解决这个问题，毕竟本地才最安全。接下来开始本地化部署操作教程。

以下内容教程，基于Windows系统进行操作。

本地安装minerU之前，需要确保你的电脑上已经安装有Conda环境，如果有显卡资源（8G显存起步），还需要提前安装好Cuda环境、显卡驱动等。这部分安装我就不多描述了，此处默认大家已经安装。

使用conda命令，创建虚拟环境。此处指定python为3.10版本。

代码语言：javascript代码运行次数：0运行复制

conda create -n mineru python=3.10

创建成功以后，激活conda环境。

代码语言：javascript代码运行次数：0运行复制

conda activate mineru

安装magic-pdf环境，主要解析工具是这个。如果本身不怕墙的，阿里云镜像后缀可以不需要。

代码语言：javascript代码运行次数：0运行复制

pip install -U magic-pdf[full] --extra-index-url  -i 

代码语言：javascript代码运行次数：0运行复制

安装完成以后，使用以下命令可以进行查看当前安装成功的版本。

代码语言：javascript代码运行次数：0运行复制

magic-pdf --version

代码语言：javascript代码运行次数：0运行复制

安装成功以后，还要继续安装 modelscope环境：

代码语言：javascript代码运行次数：0运行复制

pip install modelscope

代码语言：javascript代码运行次数：0运行复制

接下来，咱们在本地克隆一份minerU项目下来，后面会使用到：

代码语言：javascript代码运行次数：0运行复制

git clone .git

代码语言：javascript代码运行次数：0运行复制

这conda环境下，目录定位到minerU项目的脚本文件夹路径下：

执行里面的download_models.py脚本，会自动开始下载有关模型文件

下载完成以后，会自动配置好配置文件，配置文件位于你自己电脑上的 C:\Users\用户名 路径下

接着定位到项目的demo路径下，可以看到里面有测试使用的三个pdf文件

先使用CPU执行一下，看下解析度测试效果，输出到当前路径下的output目录下

代码语言：javascript代码运行次数：0运行复制

magic-pdf -p small_ocr.pdf -o ./output

代码语言：javascript代码运行次数：0运行复制

执行以后，可以看到输出了md文件，以及其他一些杂项。打开MD文件和原始的PDF文件数据进行比对看效果，初步看起来识别是成功的。

如果本地有显卡资源，显存大于8GB的用户，可以安装cuda版本pytorch有关环境进行操作。先安装指定cuda版本的pytorch有关环境：

代码语言：javascript代码运行次数：0运行复制

pip install --force-reinstall torch==2.3.1 torchvision==0.18.1 --index-url 

代码语言：javascript代码运行次数：0运行复制

我在安装期间报错了，看提示内容，是依赖的numpy包环境版本冲突。

上numpy库进行查看numpy的所有版本，找到一个不冲突进行代替，找到1.2x版本最新的是1.26.4，那咱们就用这个版本来代替吧。

代码语言：javascript代码运行次数：0运行复制

代码语言：javascript代码运行次数：0运行复制

直接安装1.26.4版本

代码语言：javascript代码运行次数：0运行复制

pip install numpy==1.26.4

代码语言：javascript代码运行次数：0运行复制

在magic-pdf的配置文件内，找到device-mode属性，把默认大模式是cpu改为cuda

改为cuda

修改完毕，直接运行，这次换一个带有图片的demo1.pdf，执行期间也可以看到输出日志，选择了cuda(显卡资源)来执行。

经过短暂的运行以后，跑完以后在指定输出的output文件夹下面，可以看到PDF文件被解析成功了，输出量md文件类型，并且里面的图片也被对应处理，放到了images文件夹下。

至此，一切准备就绪，接下来就可以对自己的PDF文档进行处理啦！

以上就是minerU本地安装配置的全部过程。没了。

本文参与 腾讯云自媒体同步曝光计划，分享自微信公众号。原始发表：2025-03-28，如有侵权请联系 cloudcommunity@tencent 删除建站教程客户端部署工具

本文标签： MinerU本地化部署教程一款AI知识库建站的必备工具