文章目录

  • 一、前言
  • 二、安装PaddlePaddle
  • 2.1 MacOS下的python安装
  • 1. 安装Anaconda
  • 2.打开终端并创建conda环境
  • 2.2 MacOS下的PIP安装
  • 一、环境准备
  • 1.1目前飞桨支持的环境
  • 1.2如何查看您的环境
  • 二、开始安装
  • 三、验证安装
  • 四、如何卸载
  • 三、下载github上PaddleOCR包
  • 四、install支持PaddleOCR的包
  • 五、参考


一、前言

现在网络上有很多百度PaddleOCR的安装教程,但普遍的问题是缺少对整个安装流程框架的讲解,而遇到的问题又五花八门,导致小白安装时容易被绕晕。

本文将梳理PaddleOCR的安装框架,同时提供几个常见报错和解决方案,希望能帮助大家高效地成功安装PaddleOCR:

  • 1.官网安装PaddlePaddle
  • 2.下载github上PaddleOCR包
  • 3.install支持PaddleOCR的包

二、安装PaddlePaddle

官方快速安装PaddlePaddle

根据自己mac电脑环境, 本次选择macOS pip python3 cpu版本的来进行安装

mac 电脑python 源码安装 python mac怎么安装_mac 电脑python 源码安装

2.1 MacOS下的python安装

1. 安装Anaconda
  • 说明:使用paddlepaddle需要先安装python环境,这里我们选择python集成环境Anaconda工具包
  • Anaconda是1个常用的python包管理程序
  • 安装完Anaconda后,可以安装python环境,以及numpy等所需的工具包环境
  • Anaconda下载:
  • 地址:https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/?C=M&O=D
  • mac 电脑python 源码安装 python mac怎么安装_paddle_02

  • 选择最下方的Anaconda3-2022.05-MacOSX-x86_64.pkg下载
  • 下载完成后,双击.pkg文件进入图形界面
  • 按默认设置即可,安装需要花费一段时间
  • 建议安装vscodepycharm等代码编辑器
2.打开终端并创建conda环境
  • 打开终端
  • 同时按下command键和空格键,在聚焦搜索中输入"终端",双击进入终端
  • 将conda加入环境变量
  • 加入环境变量是为了让系统能识别conda命令
  • 输入以下命令,在终端中打开~/.bash_profile
vim ~/.bash_profile
  • ~/.bash_profile中将conda添加为环境变量:
# 先按i进入编辑模式
# 在第一行输入:
export PATH="~/opt/anaconda3/bin:$PATH"
# 若安装时自定义了安装位置,则将~/opt/anaconda3/bin改为自定义的安装目录下的bin文件夹
# 修改后的~/.bash_profile文件应如下(其中xxx为用户名):
export PATH="~/opt/anaconda3/bin:$PATH"
# >>> conda initialize >>>
# !! Contents within this block are managed by 'conda init' !!
__conda_setup="$('/Users/xxx/opt/anaconda3/bin/conda' 'shell.bash' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
		eval "$__conda_setup"
else
		if [ -f "/Users/xxx/opt/anaconda3/etc/profile.d/conda.sh" ]; then
        		. "/Users/xxx/opt/anaconda3/etc/profile.d/conda.sh"
		else
        		export PATH="/Users/xxx/opt/anaconda3/bin:$PATH"
		fi
fi
unset __conda_setup
# <<< conda initialize <<<
  • 修改完成后,先按esc键退出编辑模式,再输入:wq!并回车,以保存退出
  • 验证是否能识别conda命令:
  • 在终端中输入source ~/.bash_profile以更新环境变量
  • 再在终端输入conda info --envs,若能显示当前有base环境,则conda已加入环境变量
  • 创建新的conda环境
# 在命令行输入以下命令,创建名为paddle_env的环境
# 此处为加速下载,使用清华源
conda create --name paddle_env python=3.8 --channel https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
  • 该命令会创建1个名为paddle_env、python版本为3.8的可执行环境,根据网络状态,需要花费一段时间
  • 之后命令行中会输出提示信息,输入y并回车继续安装
  • mac 电脑python 源码安装 python mac怎么安装_paddleOCR_03

  • 激活刚创建的conda环境,在命令行中输入以下命令:
# 激活paddle_env环境
conda activate paddle_env
# 查看当前python的位置
where python

mac 电脑python 源码安装 python mac怎么安装_paddleOCR_04

以上anaconda环境和python环境安装完毕

2.2 MacOS下的PIP安装

一、环境准备
1.1目前飞桨支持的环境
  • macOS 版本 10.x/11.x (64 bit) (不支持GPU版本)
  • mac机器上支持mac M1芯片、Intel芯片
  • Python 版本 3.6/3.7/3.8/3.9/3.10 (64 bit)
  • pip 或 pip3 版本 20.2.2或更高版本 (64 bit)
1.2如何查看您的环境
  • 可以使用以下命令查看本机的操作系统和位数信息:
uname -m && cat /etc/*release
  • 确认需要安装 PaddlePaddle 的 Python 是您预期的位置,因为您计算机可能有多个 Python

使用以下命令输出 Python 路径,根据的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径

which python
  • 需要确认python的版本是否满足要求

使用以下命令确认是 3.6/3.7/3.8/3.9/3.10

python --version
  • 需要确认pip的版本是否满足要求,要求pip版本为20.2.2或更高版本
python -m ensurepip
python -m pip --version
  • 需要确认Python和pip是64bit,并且处理器架构是x86_64(或称作x64、Intel 64、AMD64)架构 或 arm64架构(paddle已原生支持Mac M1芯片):
python -c "import platform;print(platform.architecture()[0]);print(platform.machine())"
  • 默认提供的安装包需要计算机支持MKL
  • 如果您对机器环境不了解,请下载使用快速安装脚本,配套说明请参考这里。
二、开始安装

本文档为您介绍pip安装方式

首先请选择您的版本

目前在MacOS环境仅支持CPU版PaddlePaddle

根据版本进行安装

确定您的环境满足条件后可以开始安装了,选择下面您要安装的PaddlePaddle

python -m pip install paddlepaddle==2.3.1 -i https://mirror.baidu.com/pypi/simple

注:

  • MacOS上您需要安装unrar以支持PaddlePaddle,可以使用命令brew install unrar
  • 请确认需要安装 PaddlePaddle 的 Python 是您预期的位置,因为您计算机可能有多个 Python。根据您的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径。
  • 默认下载最新稳定版的安装包,如需获取develop 版本nightly build 的安装包,请参考这里
  • 使用MacOS中自带Python可能会导致安装失败。请使用python官网提供的python3.6.x、python3.7.x、python3.8.x、python3.9.x、python3.10.x。
三、验证安装

安装完成后您可以使用 python 进入python解释器,输入import paddle ,再输入 paddle.utils.run_check()

如果出现PaddlePaddle is installed successfully!,说明您已成功安装。

四、如何卸载

请使用以下命令卸载PaddlePaddle:

python -m pip uninstall paddlepaddle

三、下载github上PaddleOCR包

根据项目文档第3步,克隆PaddleOCR代码,本地新建目录后

#推荐
git clone https://github.com/PaddlePaddle/PaddleOCR
#因为网络问题无法pull成功,也可选择使用码云上的托管, 码云托管代码可能无法实时同步本github项目更新,存在3~5天延时,请优先使用推荐方式
git clone https://gitee.com/paddlepaddle/PaddleOCR

也可直接在这里下载zip文件,解压到对应位置

mac 电脑python 源码安装 python mac怎么安装_Python_05

四、install支持PaddleOCR的包

下载github成功后进入PaddleOCR文件

cd PaddleOCR
 
python -m pip install -r requirements.txt -i https://mirror.baidu.com/pypi/simple

此处易发生的问题:

  1. PaddleOCR文档的位置:放在默认目录下即可
  1. requirements.txt 文件找不到:用dir列出目录下所有文件,再复制粘贴

install requirement.txt其实是安装的最后一步, 即安装支持PaddleOCR的必要包,其中大部分都在requirements.txt中列出。
通常的报错也是在这步报错,因为有些包安装的问题,需要手动在这里下载。网上已经有很多解决“有些包安装不上”的报错及解决方案,以下为几个常见范例:

1.shapely包:

官方建议从这里下载shapely安装包完成安装, 直接通过pip安装的shapely库可能出现找不到指定模块的问题。

下载和自己电脑,python版本吻合的文件即可

mac 电脑python 源码安装 python mac怎么安装_paddleOCR_06


下载好后放到PaddleOCR文件夹里(和requirements.txt同级)并安装(下载其他包的流程都一样)

pip install Shapely-1.7.1-cp37-cp37m-win_amd64.whl(根据下载文件的名字改)

2.Running setup.py install for python-Levenshtein … error:

mac 电脑python 源码安装 python mac怎么安装_Python_07


下载并install Python-Levenshtein

mac 电脑python 源码安装 python mac怎么安装_paddleOCR_08


注:现在网站上的很多博客有提到安装C++环境的步骤,其实也是为了解决某个python包无法安装的问题,建议采取上述步骤进行安装,比较简单快捷。如果还是有问题,可以打开requirements.txt,按照列表一个个安装。

mac 电脑python 源码安装 python mac怎么安装_Python_09

前几个安装的都很顺利,一直到python-Levenshtein库,使用pip install python-Levenshtein安装的时候出现了跟前文一样的错误,于是我猜想之前PaddleOCR安装失败大概是因为这个包没有正常安装。我就继续上网查了下如何安装python-Levenshtein,解决办法异常简单,改用conda install python-Levenshtein就可以正常安装了,后续的几个包安装没有再出现过这些问题。

最后安装PaddleOCR, pip install "paddleocr>=2.0.1".

成功安装,没有报错,bingo。

总结一下,在安装PaddleOCR之前首先要确定能否安装requirements.txt 文件里列出的包。
可以先cd 到该文件的目录下执行>python -m pip install -r requirments.txt -i https://mirror.baidu.com/pypi/simple,如果没报错就可以直接
pip install "paddleocr>=2.0.1",安装PaddleOCR,
如果报错的话可以试着一个个安装requirments.txt文件里的包,找到是哪一个安装失败,如果是pip安装失败的话可以考虑conda install 安装,亲测有用。