Install on MacOS via PIP

Environmental preparation

1.1 PREQUISITES

  • MacOS version 10.x/11.x (64 bit) (not support GPU version)

  • Python version 3.6/3.7/3.8/3.9 (64 bit)

  • pip or pip3 版本 20.2.2 or above (64 bit)

1.2 How to check your environment

  • You can use the following commands to view the local operating system and bit information

    uname -m && cat /etc/*release
    
  • Confirm that the Python where you need to install PaddlePaddle is your expected location, because your computer may have multiple Python

    • Use the following command to output Python path. Depending on the environment, you may need to replace Python in all command lines in the description with specific Python path

      which python
      
  • You need to confirm whether the version of Python meets the requirements

    • Use the following command to confirm that it is 3.6/3.7/3.8/3.9

      python --version
      
  • It is required to confirm whether the version of pip meets the requirements. The version of pip is required to be 20.2.2 or above

    python -m ensurepip
    
    python -m pip --version
    
  • You need to confirm that Python and pip are 64bit, and the processor architecture is x86_64(or called x64、Intel 64、AMD64). Currently, paddlepaddle does not support arm64 architecture, except mac M1. PaddlePaddle already supports Mac M1. The first line below outputs “64bit”, and the second line outputs “x86_64”, “x64” or “AMD64”

    python -c "import platform;print(platform.architecture()[0]);print(platform.machine())"
    
  • The installation package provided by default requires computer support for MKL

  • If you do not know the machine environment, please download and useQuick install script, for instructions please refer tohere

INSTALLATION

If you installed Python via Homebrew or the Python website, pip was installed with it. If you installed Python 3.x, then you will be using the command pip3. We will introduce pip installation here.

Choose CPU/GPU

  • Currently, only the CPU version of PaddlePaddle is supported in the MacOS environment

Installation Step

You can choose the following version of PaddlePaddle to start installation:

  • Please use the following command to install PaddlePaddle:

python -m pip install paddlepaddle==2.2.2 -i https://mirror.baidu.com/pypi/simple

Note:

  • Please confirm that the Python where you need to install PaddlePaddle is your expected location, because your computer may have multiple Python. Depending on the environment, you may need to replace Python in all command lines in the instructions with specific Python path.

  • Support the installation of Mac M1 chip. Note that when the python version is python3.9, only the intel version of python is supported, and the universal version of python is not supported.

Verify installation

After the installation is complete, you can use python to enter the Python interpreter and then use import paddle and paddle.utils.run_check()

If PaddlePaddle is installed successfully! appears, to verify that the installation was successful.

How to uninstall

Please use the following command to uninstall PaddlePaddle:

python -m pip uninstall paddlepaddle