MacOS 下从源码编译¶
环境准备¶
MacOS 版本 10.x/11.x (64 bit) (不支持 GPU 版本)
Python 版本 3.6/3.7/3.8/3.9/3.10 (64 bit)
选择 CPU/GPU¶
目前仅支持在 MacOS 环境下编译安装 CPU 版本的 PaddlePaddle
安装步骤¶
在 MacOS 系统下有 2 种编译方式,推荐使用 Docker 编译。 Docker 环境中已预装好编译 Paddle 需要的各种依赖,相较本机编译环境更简单。
使用 Docker 编译¶
Docker是一个开源的应用容器引擎。使用 Docker,既可以将 PaddlePaddle 的安装&使用与系统环境隔离,也可以与主机共享 GPU、网络等资源
使用 Docker 编译 PaddlePaddle,您需要:
在本地主机上安装 Docker
使用 Docker ID 登陆 Docker,以避免出现
Authenticate Failed
错误
请您按照以下步骤安装:
1. 进入 Mac 的终端¶
2. 请选择您希望储存 PaddlePaddle 的路径,然后在该路径下使用以下命令将 PaddlePaddle 的源码从 github 克隆到本地当前目录下名为 Paddle 的文件夹中:¶
git clone https://github.com/PaddlePaddle/Paddle.git
3. 进入 Paddle 目录下:¶
cd Paddle
4. 拉取 PaddlePaddle 镜像¶
对于国内用户,因为网络问题下载 docker 比较慢时,可使用百度提供的镜像:
CPU 版的 PaddlePaddle:
docker pull registry.baidubce.com/paddlepaddle/paddle:latest-dev
如果您的机器不在中国大陆地区,可以直接从 DockerHub 拉取镜像:
CPU 版的 PaddlePaddle:
docker pull paddlepaddle/paddle:latest-dev
您可以访问DockerHub获取与您机器适配的镜像。
5. 创建并进入满足编译环境的 Docker 容器:¶
docker run --name paddle-test -v $PWD:/paddle --network=host -it registry.baidubce.com/paddlepaddle/paddle:latest-dev /bin/bash
--name paddle-test
:为您创建的 Docker 容器命名为 paddle-test-v:$PWD:/paddle
:将当前目录挂载到 Docker 容器中的/paddle 目录下(Linux 中 PWD 变量会展开为当前路径的绝对路径)-it
:与宿主机保持交互状态registry.baidubce.com/paddlepaddle/paddle:latest-dev
:使用名为registry.baidubce.com/paddlepaddle/paddle:latest-dev
的镜像创建 Docker 容器,/bin/bash 进入容器后启动/bin/bash 命令
注意: 请确保至少为 docker 分配 4g 以上的内存,否则编译过程可能因内存不足导致失败。您可以在 docker 用户界面的“Preferences-Resources”中设置容器的内存分配上限。
6. 进入 Docker 后进入 paddle 目录下:¶
cd /paddle
7. 切换到较稳定版本下进行编译:¶
git checkout [分支名]
例如:
git checkout release/2.4
注意:python3.6、python3.7 版本从 release/1.2 分支开始支持, python3.8 版本从 release/1.8 分支开始支持, python3.9 版本从 release/2.1 分支开始支持, python3.10 版本从 release/2.3 分支开始支持
8. 创建并进入/paddle/build 路径下:¶
mkdir -p /paddle/build && cd /paddle/build
9. 使用以下命令安装相关依赖:¶
安装 protobuf 3.1.0。
pip3.7 install protobuf==3.1.0
注意:以上用 Python3.7 命令来举例,如您的 Python 版本为 3.6/3.8/3.9/3.10,请将上述命令中的 pip3.7 改成 pip3.6/pip3.8/pip3.9/pip3.10
安装 patchelf,PatchELF 是一个小而实用的程序,用于修改 ELF 可执行文件的动态链接器和 RPATH。
apt install patchelf
10. 执行 cmake:¶
对于需要编译CPU 版本 PaddlePaddle的用户(我们目前不支持 MacOS 下 GPU 版本 PaddlePaddle 的编译):
cmake .. -DPY_VERSION=3.7 -DWITH_GPU=OFF
具体编译选项含义请参见编译选项表
请注意修改参数
-DPY_VERSION
为您希望编译使用的 python 版本, 例如-DPY_VERSION=3.7
表示 python 版本为 3.7
12. 编译成功后进入/paddle/build/python/dist
目录下找到生成的.whl
包:¶
cd /paddle/build/python/dist
13. 在当前机器或目标机器安装编译好的.whl
包:¶
pip3.7 install -U [whl 包的名字]
注意: 以上用 Python3.7 命令来举例,如您的 Python 版本为 3.6/3.8/3.9/3.10,请将上述命令中的 pip3.7 改成 pip3.6/pip3.8/pip3.9/pip3.10。
恭喜,至此您已完成 PaddlePaddle 的编译安装。您只需要进入 Docker 容器后运行 PaddlePaddle,即可开始使用。更多 Docker 使用请参见Docker 官方文档¶
本机编译¶
请严格按照以下指令顺序执行
3. (Only For Python3)设置 Python 相关的环境变量:¶
a. 首先使用
find `dirname $(dirname $(which python3))` -name "libpython3.*.dylib"
找到 Pythonlib 的路径(弹出的第一个对应您需要使用的 python 的 dylib 路径),然后(下面[python-lib-path]替换为找到文件路径)
b. 设置 PYTHON_LIBRARIES:
export PYTHON_LIBRARY=[python-lib-path]
c. 其次使用找到 PythonInclude 的路径(通常是找到[python-lib-path]的上一级目录为同级目录的 include,然后找到该目录下 python3.x 的路径),然后(下面[python-include-path]替换为找到路径)
d. 设置 PYTHON_INCLUDE_DIR:
export PYTHON_INCLUDE_DIRS=[python-include-path]
e. 设置系统环境变量路径:
export PATH=[python-bin-path]:$PATH
(这里[python-bin-path]为将[python-lib-path]的最后两级目录替换为/bin/后的目录)
f. 设置动态库链接:
export LD_LIBRARY_PATH=[python-ld-path]
以及
export DYLD_LIBRARY_PATH=[python-ld-path]
(这里[python-ld-path]为[python-bin-path]的上一级目录)
g. (可选)如果您是在 MacOS 10.14 上编译 PaddlePaddle,请保证您已经安装了对应版本的 Xcode。
4. 执行编译前请您确认您的环境中安装有编译依赖表中提到的相关依赖,否则我们强烈推荐使用Homebrew
安装相关依赖。¶
MacOS 下如果您未自行修改或安装过“编译依赖表”中提到的依赖,则仅需要使用
pip
安装numpy,protobuf,wheel
,使用homebrew
安装wget,swig, unrar
,另外安装cmake
即可
5. 将 PaddlePaddle 的源码 clone 在当下目录下的 Paddle 的文件夹中,并进入 Padde 目录下:¶
git clone https://github.com/PaddlePaddle/Paddle.git
cd Paddle
6. 切换到较稳定 release 分支下进行编译:¶
git checkout [分支名]
例如:
git checkout release/2.4
注意:python3.6、python3.7 版本从 release/1.2 分支开始支持, python3.8 版本从 release/1.8 分支开始支持, python3.9 版本从 release/2.1 分支开始支持, python3.10 版本从 release/2.3 分支开始支持
7. 并且请创建并进入一个叫 build 的目录下:¶
mkdir build && cd build
8. 执行 cmake:¶
具体编译选项含义请参见编译选项表
若您的机器为 Mac M1 机器,需要编译Arm 架构、CPU 版本 PaddlePaddle:
cmake .. -DPY_VERSION=3.8 -DPYTHON_INCLUDE_DIR=${PYTHON_INCLUDE_DIRS} \ -DPYTHON_LIBRARY=${PYTHON_LIBRARY} -DWITH_GPU=OFF \ -DWITH_AVX=OFF -DWITH_ARM=ON
若您的机器不是 Mac M1 机器,需要编译x86_64 架构、CPU 版本 PaddlePaddle:
cmake .. -DPY_VERSION=3.8 -DPYTHON_INCLUDE_DIR=${PYTHON_INCLUDE_DIRS} \ -DPYTHON_LIBRARY=${PYTHON_LIBRARY} -DWITH_GPU=OFF
-DPY_VERSION=3.8
请修改为安装环境的 Python 版本若编译 arm 架构的 paddlepaddle,需要
cmake
版本为 3.19.2 以上
9. 使用以下命令来编译:¶
若您的机器为 Mac M1 机器,需要编译Arm 架构、CPU 版本 PaddlePaddle:
make TARGET=ARMV8 -j4
若您的机器不是 Mac M1 机器,需要编译x86_64 架构、CPU 版本 PaddlePaddle:
make -j4
10. 编译成功后进入/paddle/build/python/dist
目录下找到生成的.whl
包:¶
cd /paddle/build/python/dist
恭喜,至此您已完成 PaddlePaddle 的编译安装¶
验证安装¶
安装完成后您可以使用 python
或 python3
进入 python 解释器,输入
import paddle
再输入
paddle.utils.run_check()
如果出现PaddlePaddle is installed successfully!
,说明您已成功安装。
如何卸载¶
请使用以下命令卸载 PaddlePaddle
CPU 版本的 PaddlePaddle:
pip uninstall paddlepaddle
或
pip3 uninstall paddlepaddle
使用 Docker 安装 PaddlePaddle 的用户,请进入包含 PaddlePaddle 的容器中使用上述命令,注意使用对应版本的 pip