Skip to content

Quick Installation

Quick Installation

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

PaddleOCR working environment:

  • PaddlePaddle 2.0.0
  • Python 3.7
  • glibc 2.23

It is recommended to use the docker provided by us to run PaddleOCR. Please refer to the docker tutorial link.

If you want to directly run the prediction code on Mac or Windows, you can start from step 2.

For the first time you use this docker image, it will be downloaded automatically. Please be patient.

1
2
3
4
5
6
7
# 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

#If using CPU, use docker instead of nvidia-docker to create docker
sudo docker run --name ppocr -v $PWD:/paddle --network=host -it  paddlepaddle/paddle:latest-dev-cuda10.1-cudnn7-gcc82  /bin/bash

With 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:

1
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

You can also visit DockerHub to get the image that fits your machine.

1
2
# ctrl+P+Q to exit docker, to re-enter docker using the following command:
sudo docker container exec -it ppocr /bin/bash

2. Install PaddlePaddle 2.0

1
2
3
4
5
6
7
pip3 install --upgrade pip

# If you have cuda9 or cuda10 installed on your machine, please run the following command to install
python3 -m pip install paddlepaddle-gpu==2.0.0 -i https://mirror.baidu.com/pypi/simple

# If you only have cpu on your machine, please run the following command to install
python3 -m pip install paddlepaddle==2.0.0 -i https://mirror.baidu.com/pypi/simple

For more software version requirements, please refer to the instructions in Installation Document for operation.

3. Clone PaddleOCR repo

1
2
3
4
5
6
7
8
# Recommend
git clone https://github.com/PaddlePaddle/PaddleOCR

# If you cannot pull successfully due to network problems, you can switch to the mirror hosted on Gitee:

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

# Note: The mirror on Gitee may not keep in synchronization with the latest update with the project on GitHub. There might be a delay of 3-5 days. Please try GitHub at first.

4. Install third-party libraries

1
2
cd PaddleOCR
pip3 install -r requirements.txt

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 from http://www.lfd.uci.edu/~gohlke/pythonlibs/#shapely.

Reference: Solve shapely installation on windows

Comments