PaddleOCR/doc/doc_ch/installation.md

83 lines
3.6 KiB
Markdown
Raw Normal View History

2020-05-12 15:04:33 +08:00
## 快速安装
2020-05-25 16:29:20 +08:00
经测试PaddleOCR可在glibc 2.23上运行您也可以测试其他glibc版本或安装glic 2.23
PaddleOCR 工作环境
2020-10-13 17:49:16 +08:00
- PaddlePaddle 1.8+ ,推荐使用 PaddlePaddle 2.0.0.beta
2020-07-31 21:47:26 +08:00
- python3.7
2020-05-25 16:29:20 +08:00
- glibc 2.23
2020-07-15 20:23:23 +08:00
- cuDNN 7.6+ (GPU)
2020-05-25 16:29:20 +08:00
2020-10-13 17:49:16 +08:00
建议使用我们提供的docker运行PaddleOCR有关docker、nvidia-docker使用请参考[链接](https://www.runoob.com/docker/docker-tutorial.html/)。
2020-05-25 16:29:20 +08:00
2020-06-04 19:41:42 +08:00
*如您希望使用 mac 或 windows直接运行预测代码可以从第2步开始执行。*
2020-08-11 20:22:26 +08:00
**1. 建议准备docker环境。第一次使用这个镜像会自动下载该镜像请耐心等待。**
```
# 切换到工作目录下
cd /home/Projects
2020-05-12 15:04:33 +08:00
# 首次运行需创建一个docker容器再次运行时不需要运行当前命令
2020-05-14 13:57:40 +08:00
# 创建一个名字为ppocr的docker容器并将当前目录映射到容器的/paddle目录下
如果您希望在CPU环境下使用docker使用docker而不是nvidia-docker创建docker
sudo docker run --name ppocr -v $PWD:/paddle --network=host -it hub.baidubce.com/paddlepaddle/paddle:latest-gpu-cuda9.0-cudnn7-dev /bin/bash
2020-08-03 17:44:41 +08:00
如果使用CUDA9请运行以下命令创建容器
2020-05-14 13:57:40 +08:00
sudo nvidia-docker run --name ppocr -v $PWD:/paddle --network=host -it hub.baidubce.com/paddlepaddle/paddle:latest-gpu-cuda9.0-cudnn7-dev /bin/bash
2020-08-03 17:44:41 +08:00
如果使用CUDA10请运行以下命令创建容器
2020-05-14 13:57:40 +08:00
sudo nvidia-docker run --name ppocr -v $PWD:/paddle --network=host -it hub.baidubce.com/paddlepaddle/paddle:latest-gpu-cuda10.0-cudnn7-dev /bin/bash
您也可以访问[DockerHub](https://hub.docker.com/r/paddlepaddle/paddle/tags/)获取与您机器适配的镜像。
2020-05-12 15:04:33 +08:00
# ctrl+P+Q可退出docker重新进入docker使用如下命令
sudo docker container exec -it ppocr /bin/bash
2020-05-14 13:57:40 +08:00
```
2020-05-25 16:29:20 +08:00
注意如果docker pull过慢可以按照如下步骤手动下载后加载docker,以cuda9 docker为例使用cuda10 docker只需要将cuda9改为cuda10即可。
```
# 下载CUDA9 docker的压缩文件并解压
wget https://paddleocr.bj.bcebos.com/docker/docker_pdocr_cuda9.tar.gz
# 为减少下载时间上传的docker image是压缩过的需要解压使用
tar zxf docker_pdocr_cuda9.tar.gz
# 创建image
docker load < docker_pdocr_cuda9.tar
# 完成上述步骤后通过docker images检查是否加载了下载的镜像
docker images
# 执行docker images后如果有下面的输出即可按照按照 步骤1 创建docker环境。
hub.baidubce.com/paddlepaddle/paddle latest-gpu-cuda9.0-cudnn7-dev f56310dcc829
```
2020-10-13 17:49:16 +08:00
**2. 安装PaddlePaddle Fluid v2.0**
2020-05-14 13:57:40 +08:00
```
pip3 install --upgrade pip
2020-10-13 17:49:16 +08:00
如果您的机器安装的是CUDA9或CUDA10请运行以下命令安装
python3 -m pip install paddlepaddle-gpu==2.0.0b0 -i https://mirror.baidu.com/pypi/simple
2020-05-14 13:57:40 +08:00
2020-06-04 19:41:42 +08:00
如果您的机器是CPU请运行以下命令安装
2020-10-13 17:49:16 +08:00
python3 -m pip install paddlepaddle==2.0.0b0 -i https://mirror.baidu.com/pypi/simple
2020-06-04 19:41:42 +08:00
2020-05-14 13:57:40 +08:00
更多的版本需求,请参照[安装文档](https://www.paddlepaddle.org.cn/install/quick)中的说明进行操作。
```
2020-08-11 20:22:26 +08:00
**3. 克隆PaddleOCR repo代码**
```
2020-06-01 17:03:26 +08:00
【推荐】git clone https://github.com/PaddlePaddle/PaddleOCR
如果因为网络问题无法pull成功也可选择使用码云上的托管
git clone https://gitee.com/paddlepaddle/PaddleOCR
2020-06-01 17:17:13 +08:00
码云托管代码可能无法实时同步本github项目更新存在3~5天延时请优先使用推荐方式。
```
2020-08-11 20:22:26 +08:00
**4. 安装第三方库**
```
cd PaddleOCR
2020-05-14 13:57:40 +08:00
pip3 install -r requirments.txt
```
2020-07-23 15:35:23 +08:00
注意windows环境下建议从[这里](https://www.lfd.uci.edu/~gohlke/pythonlibs/#shapely)下载shapely安装包完成安装
直接通过pip安装的shapely库可能出现`[winRrror 126] 找不到指定模块的问题`。