Installation on macOS via Conda

Anacondais a free and open source distribution of Python and R for computational science. Anaconda is dedicated to simplifying package management and deployment. Anaconda’s packages are managed using the package management system Conda. Conda is an open source package management system and environment management system that runs on Windows, macOS, and Linux.

Environmental preparation

1.1 Create Virtual Environment

1.1.1 Create the Anaconda Virtual Environment

Create virtual environment First create the Anaconda virtual environment according to the specific Python version. The Anaconda installation of PaddlePaddle supports Python version of 3.8 - 3.12.

conda create -n paddle_env python=YOUR_PY_VER

1.1.2 Enter the Anaconda Virtual Environment

conda activate paddle_env

1.2 Confirm Other Environments

Confirm that your conda virtual environment and the Python loaction which is preapared to install PaddlePaddle are where you expected them for your computer may have multiple Pythons environments. Enter Anaconda’s command line terminal and enter the following command to confirm the Python location.

1.2.1 Confirm the installation path of python

Depending on your environment, you may need to replace python3 in all command lines in the instructions with specific Python path.

The command to get the Python path is:

which python3

1.2.2 Check the version of Python

Use the following command to confirm it’s version

python3 --version

1.2.3 Check the system environment

Confirm that Python and pip are 64bit, and the processor architecture is x86_64(or called x64、Intel 64、AMD64) or arm64 (PaddlePaddle already supports Mac M1):

python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())"


We will introduce conda installation here.

Add Tsinghua source (optional)

For domestic users who cannot connect to the Anaconda official source, you can add Tsinghua source according to the following command.

conda config --add channels
conda config --add channels
conda config --set show_channel_urls yes

Install the CPU version of PaddlePaddle

  • Currently, only the CPU version of PaddlePaddle is supported in the macOS environment. Please use the following command to install PaddlePaddle:

    conda install paddlepaddle==3.0.0b1 -c paddle

Verify installation

After the installation is complete, you can use python3 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.