文章目录
- 一、前言
- 二、安装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
根据自己mac电脑环境, 本次选择macOS pip python3 cpu
版本的来进行安装
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
- 选择最下方的
Anaconda3-2022.05-MacOSX-x86_64.pkg
下载
- 下载完成后,双击
.pkg
文件进入图形界面
- 按默认设置即可,安装需要花费一段时间
- 建议安装
vscode
或pycharm
等代码编辑器
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
并回车继续安装
- 激活刚创建的conda环境,在命令行中输入以下命令:
# 激活paddle_env环境
conda activate paddle_env
# 查看当前python的位置
where python
以上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文件,解压到对应位置
四、install支持PaddleOCR的包
下载github成功后进入PaddleOCR文件
cd PaddleOCR
python -m pip install -r requirements.txt -i https://mirror.baidu.com/pypi/simple
此处易发生的问题:
- PaddleOCR文档的位置:放在默认目录下即可
- requirements.txt 文件找不到:用dir列出目录下所有文件,再复制粘贴
install requirement.txt其实是安装的最后一步, 即安装支持PaddleOCR的必要包,其中大部分都在requirements.txt中列出。
通常的报错也是在这步报错,因为有些包安装的问题,需要手动在这里下载。网上已经有很多解决“有些包安装不上”的报错及解决方案,以下为几个常见范例:
1.shapely包:
官方建议从这里下载shapely安装包完成安装, 直接通过pip安装的shapely库可能出现找不到指定模块的问题。
下载和自己电脑,python版本吻合的文件即可
下载好后放到PaddleOCR文件夹里(和requirements.txt同级
)并安装(下载其他包的流程都一样)
pip install Shapely-1.7.1-cp37-cp37m-win_amd64.whl(根据下载文件的名字改)
2.Running setup.py install for python-Levenshtein … error:
下载并install Python-Levenshtein
注:现在网站上的很多博客有提到安装C++环境的步骤,其实也是为了解决某个python包无法安装的问题,建议采取上述步骤进行安装,比较简单快捷。如果还是有问题,可以打开requirements.txt,按照列表一个个安装。
前几个安装的都很顺利,一直到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 安装,亲测有用。