mirror of
https://github.com/PaddlePaddle/PaddleOCR.git
synced 2025-10-31 09:49:30 +00:00
72 lines
3.3 KiB
Markdown
72 lines
3.3 KiB
Markdown
## QUICK INSTALLATION
|
|
|
|
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:
|
|
- PaddlePaddle 1.8+, Recommend PaddlePaddle 2.0rc1
|
|
- python3.7
|
|
- glibc 2.23
|
|
|
|
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/).
|
|
|
|
*If you want to directly run the prediction code on mac or windows, you can start from step 2.*
|
|
|
|
**1. (Recommended) Prepare a docker environment. The first time you use this docker image, it will be downloaded automatically. Please be patient.**
|
|
```
|
|
# 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
|
|
```
|
|
|
|
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:
|
|
```
|
|
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](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
|
|
```
|
|
|
|
**2. Install PaddlePaddle Fluid v2.0**
|
|
```
|
|
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.0rc1 -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.0rc1 -i https://mirror.baidu.com/pypi/simple
|
|
```
|
|
For more software version requirements, please refer to the instructions in [Installation Document](https://www.paddlepaddle.org.cn/install/quick) for operation.
|
|
|
|
|
|
**3. Clone PaddleOCR repo**
|
|
```
|
|
# 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.
|
|
```
|
|
|
|
**4. Install third-party libraries**
|
|
```
|
|
cd PaddleOCR
|
|
pip3 install -r requirments.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 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)
|