installation_en.md 3.3 KB
Newer Older
X
xxxpsyduck 已提交
1
## QUICK INSTALLATION
K
Khanh Tran 已提交
2 3 4 5

After testing, paddleocr can run on glibc 2.23. You can also test other glibc versions or install glic 2.23 for the best compatibility.

PaddleOCR working environment:
L
LDOUBLEV 已提交
6
- PaddlePaddle1.8+, Recommend PaddlePaddle 2.0rc0
D
dyning 已提交
7
- python3.7
K
Khanh Tran 已提交
8
- glibc 2.23
G
grasswolfs 已提交
9

W
WenmuZhou 已提交
10
It is recommended to use the docker provided by us to run PaddleOCR, please refer to the use of docker [link](https://www.runoob.com/docker/docker-tutorial.html/).
K
Khanh Tran 已提交
11

G
grasswolfs 已提交
12 13
*If you want to directly run the prediction code on mac or windows, you can start from step 2.*

L
LDOUBLEV 已提交
14
**1. (Recommended) Prepare a docker environment. The first time you use this docker image, it will be downloaded automatically. Please be patient.**
K
Khanh Tran 已提交
15 16 17 18 19 20
```
# Switch to the working directory
cd /home/Projects
# You need to create a docker container for the first run, and do not need to run the current command when you run it again
# Create a docker container named ppocr and map the current directory to the /paddle directory of the container

L
LDOUBLEV 已提交
21
#If using CPU, use docker instead of nvidia-docker to create docker
L
LDOUBLEV 已提交
22
sudo docker run --name ppocr -v $PWD:/paddle --network=host -it  paddlepaddle/paddle:latest-dev-cuda10.1-cudnn7-gcc82  /bin/bash
K
Khanh Tran 已提交
23
```
L
LDOUBLEV 已提交
24 25 26

If using CUDA10, please run the following command to create a container.
It is recommended to set a shared memory greater than or equal to 32G through the --shm-size parameter:
K
Khanh Tran 已提交
27
```
L
LDOUBLEV 已提交
28
sudo nvidia-docker run --name ppocr -v $PWD:/paddle --shm-size=64G --network=host -it paddlepaddle/paddle:latest-dev-cuda10.1-cudnn7-gcc82 /bin/bash
K
Khanh Tran 已提交
29 30 31 32 33 34 35
```
You can also visit [DockerHub](https://hub.docker.com/r/paddlepaddle/paddle/tags/) to get the image that fits your machine.
```
# ctrl+P+Q to exit docker, to re-enter docker using the following command:
sudo docker container exec -it ppocr /bin/bash
```

W
WenmuZhou 已提交
36
**2. Install PaddlePaddle Fluid v2.0**
K
Khanh Tran 已提交
37 38 39
```
pip3 install --upgrade pip

W
WenmuZhou 已提交
40
# If you have cuda9 or cuda10 installed on your machine, please run the following command to install
L
LDOUBLEV 已提交
41
python3 -m pip install paddlepaddle-gpu==2.0rc0 -i https://mirror.baidu.com/pypi/simple
G
grasswolfs 已提交
42 43

# If you only have cpu on your machine, please run the following command to install
L
LDOUBLEV 已提交
44
python3 -m pip install paddlepaddle==2.0rc0 -i https://mirror.baidu.com/pypi/simple
K
Khanh Tran 已提交
45 46 47 48
```
For more software version requirements, please refer to the instructions in [Installation Document](https://www.paddlepaddle.org.cn/install/quick) for operation.


M
MissPenguin 已提交
49
**3. Clone PaddleOCR repo**
K
Khanh Tran 已提交
50 51 52 53 54 55 56 57 58 59 60
```
# Recommend
git clone https://github.com/PaddlePaddle/PaddleOCR

# If you cannot pull successfully due to network problems, you can also choose to use the code hosting on the cloud:

git clone https://gitee.com/paddlepaddle/PaddleOCR

# Note: The cloud-hosting code may not be able to synchronize the update with this GitHub project in real time. There might be a delay of 3-5 days. Please give priority to the recommended method.
```

M
MissPenguin 已提交
61
**4. Install third-party libraries**
K
Khanh Tran 已提交
62 63 64 65
```
cd PaddleOCR
pip3 install -r requirments.txt
```
L
LDOUBLEV 已提交
66 67 68 69 70 71

If you getting this error `OSError: [WinError 126] The specified module could not be found` when you install shapely on windows.

Please try to download Shapely whl file using [http://www.lfd.uci.edu/~gohlke/pythonlibs/#shapely](http://www.lfd.uci.edu/~gohlke/pythonlibs/#shapely).

Reference: [Solve shapely installation on windows](https://stackoverflow.com/questions/44398265/install-shapely-oserror-winerror-126-the-specified-module-could-not-be-found)