Install on MacOS¶

Install using pip¶

Due to the large difference in Python situation in MacOS, we do not provide quick installation commands. Please follow the steps below to install.

First, check whether your computer and operating system meet our supported compilation standards or not by uname -m and view the system version About This Mac in the Apple menu.

Second, your computer needs to meet the following requirements:

Please do not use the Python originally provided by MacOS. For Python 2, we recommend Python2.7.15 provided by Homebrew or Python.org. For Python3, please use python3.5.x, Python3.6.x or python3.7.x provided by Python.org.

	For python2: brew install python@2 or use Python officially downloaded python2.7.15
	For python3: Use python3.5.x, python3.6.x or python3.7.x downloaded from Python official site

• Python2.7.x, Pip >= 9.0.1

• Python3.5.x, Pip3 >= 9.0.1

• Python3.6.x, Pip3 >= 9.0.1

• Python3.7.x, Pip3 >= 9.0.1

  Note: You may have installed pip on your MacOS. Please use pip -V to confirm that its version is the recommended pip 9.0.1 or higher.

Here’s how to install PaddlePaddle:

1. Use pip install to install PaddlePaddle:

   • For users who need the CPU version PaddlePaddle: pip install paddlepaddle or pip3 install paddlepaddle

   • For users with other requirements: pip install paddlepaddle==[version number] or pip3 install paddlepaddle==[version number]

   For the version number, please refer to the latest Release installation package list. If you need to obtain and install the latest PaddlePaddle development branch, you can download the latest whl installation package and c-api development package from the CI system and install it. To log in, click on “Log in as guest”.

Now you have completed the process of installing PaddlePaddle via pip install.

Install using Docker¶

In order to better use Docker and avoid problems, we recommend using the highest version of Docker. For details on installing and using Docker, please refer to the official Docker documentation.

Please note that running docker on MacOS requires logging in with your dockerID, otherwise an Authenticate Failed error will occur.

If Docker is properly installed, you can start using Docker to install PaddlePaddle.

1. Use the following command to pull the image we pre-installed for PaddlePaddle:

   • For users who need the CPU version of PaddlePaddle, use the following command to pull the image we pre-installed for your PaddlePaddle For CPU:

     Docker pull hub.baidubce.com/paddlepaddle/paddle: 1.2

   • You can also pull any of our Docker images by following the instructions below:

     Docker pull hub.baidubce.com/paddlepaddle/paddle:[tag]

     (Please replace [tag] with the contents of the mirror table)

2. Use the following command to build from the already pulled image and enter the Docker container:

   Docker run --name [Name of container] -it -v $PWD:/paddle <imagename> /bin/bash

   In the above command, –name [Name of container] sets the name of the Docker; the -it parameter indicates that the container is running interactively with the host machine; -v $PWD:/paddle specifies the current path (the PWD variable in Linux will expand to The absolute path ) of the current path is mounted to the /paddle directory inside the container; <imagename> specifies the name of the image to use, if you need to use our image please use hub.baidubce.com/paddlepaddle/paddle:[tag]. Note: The meaning of tag is the same as the second step; /bin/bash is the command to be executed in Docker.

3. (Optional: When you need to enter the Docker container a second time) re-enter the PaddlePaddle container with the following command:

   Docker start [Name of container]

   start the container created previously.

   Docker attach [Name of container]

   Enter the started container.

Now that you have successfully installed PaddlePaddle using Docker, you only need to run PaddlePaddle after entering the Docker container. For more Docker usage, please refer to the official Docker documentation.

Note: In order to reduce the size, vim is not installed in PaddlePaddle Docker image by default. You can edit the code in the container after executing apt-get install -y vim in the container.