From 14c25ab6f790b603b0b6f1c5447c3ff467d296dc Mon Sep 17 00:00:00 2001 From: zhongpu <2013000149@qq.com> Date: Mon, 26 Aug 2019 15:29:21 +0800 Subject: [PATCH] fix for install doc in develop, test=develop, test=document_preview (#1115) * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview * fix for install doc in develop, test=develop, test=document_preview --- .../beginners_guide/install/index_cn.rst | 315 ++++++++++++++---- .../beginners_guide/install/install_CentOS.md | 65 +++- .../beginners_guide/install/install_Conda.md | 106 ++++++ .../beginners_guide/install/install_MacOS.md | 56 +++- .../beginners_guide/install/install_Ubuntu.md | 65 +++- .../install/install_Windows.md | 60 +++- 6 files changed, 567 insertions(+), 100 deletions(-) create mode 100644 doc/fluid/beginners_guide/install/install_Conda.md diff --git a/doc/fluid/beginners_guide/install/index_cn.rst b/doc/fluid/beginners_guide/install/index_cn.rst index f63bb2127..fd0d1dd0b 100644 --- a/doc/fluid/beginners_guide/install/index_cn.rst +++ b/doc/fluid/beginners_guide/install/index_cn.rst @@ -16,7 +16,14 @@ * 操作系统要求是 64 位版本 -2. Python 和 pip 版本要求： +2. 处理器要求 +============================ + +* 处理器支持 MKL + +* 处理器架构是x86_64（或称作 x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构 + +3. Python 和 pip 版本要求： ============================ * Python 2 的版本要求 2.7.15+ @@ -27,7 +34,7 @@ * Python 和 pip 要求是 64 位版本 -3. PaddlePaddle 对 GPU 支持情况： +4. PaddlePaddle 对 GPU 支持情况： ================================= * 目前 `PaddlePaddle` 仅支持 `NVIDIA` 显卡的 `CUDA` 驱动 @@ -39,31 +46,31 @@ * 需要安装 `CUDA `_，根据您系统不同，对 CUDA 版本要求不同： * Windows 安装 GPU 版本 - * Windows 7/8/10.0 支持 CUDA 8/9 单卡模式 + * Windows 7/8/10 支持 CUDA 8.0/9.0 单卡模式，不支持 CUDA 9.1/9.2/10.0/10.1 * 不支持 `nvidia-docker` 方式安装 * Ubuntu 安装 GPU 版本 - * Ubuntu 14.04 支持 CUDA 8/10.0 + * Ubuntu 14.04 支持 CUDA 8.0/10.0，不支持CUDA 9.0/9.1/9.2/10.1 - * Ubuntu 16.04 支持 CUDA 8/9/10.0 + * Ubuntu 16.04 支持 CUDA 8.0/9.0/9.1/9.2/10.0，不支持10.1 - * Ubuntu 18.04 支持 CUDA 10.0 + * Ubuntu 18.04 支持 CUDA 10.0，不支持CUDA 8.0/9.0/9.1/9.2/10.1 - * 如果您是使用 `nvidia-docker` 安装，支持 CUDA 8/9/10.0 + * 如果您是使用 `nvidia-docker` 安装，支持 CUDA 8.0/9.0/9.1/9.2/10.0，不支持10.1 * CentOS 安装 GPU 版本 * 如果您是使用本机 `pip` 安装： - * CentOS 7 支持 CUDA 9/10.0，支持 CUDA 8 但仅支持单卡模式 + * CentOS 7 支持 CUDA 9.0/9.1/9.2/10.0，不支持10.1，支持 CUDA 8.0 但仅支持单卡模式 - * CentOS 6 支持 CUDA 8/9 单卡模式 + * CentOS 6 支持 CUDA 8.0/9.0/9.1/9.2 单卡模式，不支持10.0/10.1 * 如果您是使用本机源码编译安装： - * CentOS 7 支持 CUDA 9/10.0 + * CentOS 7 支持 CUDA 9.0/9.1/9.2/10.0 * CentOS 6 不推荐，不提供编译出现问题时的官方支持 - * 如果您是使用 `nvidia-docker` 安装，在CentOS 7 下支持 CUDA 8/9/10.0。 + * 如果您是使用 `nvidia-docker` 安装，在CentOS 7 下支持 CUDA 8.0/9.0/9.1/9.2/10.0，不支持10.1 * MacOS 不支持：PaddlePaddle 在 MacOS 平台没有 GPU 支持 @@ -72,15 +79,45 @@ 第一种安装方式：使用 pip 安装 ================================ -您可以选择“使用pip安装”、“使用docker安装”、“从源码编译安装” 三种方式中的任意一种方式进行安装。 +您可以选择“使用pip安装”、“使用conda安装”、“使用docker安装”、“从源码编译安装” 四种方式中的任意一种方式进行安装。 本节将介绍使用 `pip` 的安装方式。 1. 需要您确认您的 操作系统 满足上方列出的要求 -2. 处理器支持 MKL +2. 需要您确认您的 处理器 满足上方列出的要求 + +3. 确认您需要安装 PaddlePaddle 的 Python 是您预期的位置，因为您计算机可能有多个 Python + + 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + 在 Windows 环境下，输出 Python 路径的命令为： + + :: + + where python + + 在 MacOS/Linux 环境下，输出 Python 路径的命令为： + + :: + + which python + + 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + 在 Windows 环境下，输出 Python 路径的命令为： + + :: + + where python3 + + 在 MacOS/Linux 环境下，输出 Python 路径的命令为： + + :: + + which python3 -3. 检查 Python 的版本 +4. 检查 Python 的版本 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ :: @@ -92,112 +129,251 @@ python3 --version -4. 检查 pip 的版本，确认是 9.0.1+ +5. 检查 pip 的版本，确认是 9.0.1+ 如果您是使用 Python 2 :: - pip --version + python -m ensurepip + python -m pip --version 如果您是使用 Python 3 :: - pip3 --version + python3 -m ensurepip + python3 -m pip --version -5. 确认 Python 和 pip 是 64 bit，下面的命令输出的是 "64bit" 即可： +6. 确认 Python 和 pip 是 64 bit，并且处理器架构是x86_64（或称作 x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是 "64bit" ，第二行输出的是 "x86_64" 、 "x64" 或 "AMD64" 即可： 如果您是使用 Python 2 :: - - python -c "import platform;print(platform.architecture()[0])" + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" 如果您是使用 Python 3 :: - python3 -c "import platform;print(platform.architecture()[0])" - -6. 如果您希望使用 `pip `_ 进行安装PaddlePaddle可以直接使用以下命令: - -- 注意：目前官方没有对 `conda` 和 `anaconda` 进行支持，使用他们所附带的 `pip` 安装 `paddlepaddle` 也可能会带来冲突。所以建议使用纯净的 Python 环境的 `pip` 进行安装。 + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" +7. 如果您希望使用 `pip `_ 进行安装PaddlePaddle可以直接使用以下命令: - (1). **CPU版本**：如果您只是想安装CPU版本请参考如下命令安装 + (1). **CPU版本**：如果您只是想安装CPU版本请参考如下命令安装（使用清华源） 如果您是使用 Python 2，安装CPU版本的命令为： :: - pip install paddlepaddle + python -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple 如果您是使用 Python 3，安装CPU版本的命令为： :: - pip3 install paddlepaddle + python3 -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple - (2). **GPU版本**：如果您想使用GPU版本请参考如下命令安装 + (2). **GPU版本**：如果您想使用GPU版本请参考如下命令安装（使用清华源） 注意： - * 您的计算机需要具有支持 `CUDA` 驱动的 `NVIDIA` 显卡 + * 需要您确认您的 GPU 满足上方列出的要求 - * 需要安装 `cuDNN `_ ，版本要求 7.3+ + 如果您是使用 Python2，请注意用以下指令安装的PaddlePaddle在Windows下默认支持CUDA9，Ubuntu、CentOS下默认支持CUDA10.0： + :: - * 如果您需要 GPU 多卡模式，需要安装 `NCCL 2 `_ - * 仅 Ubuntu/CentOS 支持 NCCL 2 技术 + python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple - * 需要安装 `CUDA `_，根据您系统不同，对 CUDA 版本要求不同： - * Windows 7/8/10.0 支持 CUDA 8/9 单卡模式 + 如果您是使用 Python 2，CUDA 8，cuDNN 7.1+，安装GPU版本的命令为： + :: + + python -m pip install paddlepaddle-gpu==1.5.1.post87 -i https://pypi.tuna.tsinghua.edu.cn/simple - * Ubuntu - * Ubuntu 14.04 支持 CUDA 8/10.0 + 如果您是使用 Python 2，CUDA 9，cuDNN 7.3+，安装GPU版本的命令为： + :: + + python -m pip install paddlepaddle-gpu==1.5.1.post97 -i https://pypi.tuna.tsinghua.edu.cn/simple - * Ubuntu 16.04 支持 CUDA 8/9/10.0 + 如果您是使用 Python 2，CUDA 10.0，cuDNN 7.3+，安装GPU版本的命令为： + :: + + python -m pip install paddlepaddle-gpu==1.5.1.post107 -i https://pypi.tuna.tsinghua.edu.cn/simple + + 如果您是使用 Python 3，请将上述命令中的 `python` 更换为 `python3` 进行安装。 - * Ubuntu 18.04 支持 CUDA 10.0 +8. 验证安装 - * CentOS - * CentOS 7 支持 CUDA 9/10.0 ，CUDA 8 仅具有单卡模式支持 + 使用 python 或 python3 进入python解释器，输入import paddle.fluid ，再输入 paddle.fluid.install_check.run_check()。 - * CentOS 6 支持 CUDA 8/9 单卡模式 + 如果出现 Your Paddle Fluid is installed succesfully!，说明您已成功安装。 - * MacOS 不支持：PaddlePaddle 在 MacOS 平台没有 GPU 支持 +9. 更多帮助信息请参考： + `Ubuntu下安装 `_ + `CentOS下安装 `_ + + `MacOS下安装 `_ + + `Windows下安装 `_ + + +第二种安装方式：使用 conda 安装 +================================ + +您可以选择“使用pip安装”、“使用conda安装”、“使用docker安装”、“从源码编译安装” 四种方式中的任意一种方式进行安装。 + +本节将介绍使用 `conda` 的安装方式。 + +1. 需要您确认您的 操作系统 满足上方列出的要求 + +2. 需要您确认您的 处理器 满足上方列出的要求 + +3. 对于国内用户无法连接到Anaconda官方源的可以按照以下命令添加清华源进行安装。 + + :: + + conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ + conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ + conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/Paddle/ + conda config --set show_channel_urls yes + +4. 如果您需要新建 conda 的虚拟环境专门给 Paddle 使用（--name后边的环境名称，您可以自己选择）： + + 如果您是使用 Python2 并且在 Window 环境下 + + :: + + conda create --name paddle python=2.7 + activate paddle + + 如果您是使用 Python2 并且在 MacOS/Linux 环境下 + + :: + + conda create --name paddle python=2.7 + conda activate paddle + + 如果您是使用 Python3 并且在 Window 环境下，注意：python3版本可以是3.5.1+/3.6/3.7 + + :: + + conda create --name paddle python=3.7 + activate paddle + + 如果您是使用 Python3 并且在 MacOS/Linux 环境下，注意：python3版本可以是3.5.1+/3.6/3.7 + + :: + + conda create --name paddle python=3.7 + conda activate paddle + +5. 确认您需要安装 PaddlePaddle 的 Python 是您预期的位置，因为您计算机可能有多个 Python，进入 Anaconda 的命令行终端，输入以下指令确认 Python 位置 + + 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + 在 Windows 环境下，输出 Python 路径的命令为： + + :: + + where python + + 在 MacOS/Linux 环境下，输出 Python 路径的命令为： - 如果您是使用 Python2，请注意用以下指令安装的PaddlePaddle在Windows下默认支持CUDA9，Ubuntu、CentOS下默认支持CUDA10.0： :: - pip install paddlepaddle-gpu + which python + + 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + 在 Windows 环境下，输出 Python 路径的命令为： + + :: + + where python3 + + 在 MacOS/Linux 环境下，输出 Python 路径的命令为： - 如果您是使用 Python 2，CUDA 8，cuDNN 7.3+，安装GPU版本的命令为： :: + + which python3 + +6. 检查 Python 的版本 + + 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ + :: - pip install paddlepaddle-gpu==1.5.1.post87 + python --version - 如果您是使用 Python 2，CUDA 9，cuDNN 7.3+，安装GPU版本的命令为： + 如果您是使用 Python 3，使用以下命令确认是 3.5.1+/3.6/3.7 + :: + + python3 --version + +7. 检查 pip 的版本，确认是 9.0.1+ + + 如果您是使用 Python 2 + :: + + python -m ensurepip + python -m pip --version + + 如果您是使用 Python 3 + :: + + python3 -m ensurepip + python3 -m pip --version + +8. 确认 Python 和 pip 是 64 bit，并且处理器架构是x86_64（或称作 x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是 "64bit" ，第二行输出的是 "x86_64" 、 "x64" 或 "AMD64" 即可： + + 如果您是使用 Python 2 + :: + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + + 如果您是使用 Python 3 + :: + + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + +9. 如果您希望使用 conda 进行安装PaddlePaddle可以直接使用以下命令: + + (1). **CPU版本**：如果您只是想安装CPU版本请参考如下命令安装 + + :: + + conda install paddlepaddle + + + (2). **GPU版本**：如果您想使用GPU版本请参考如下命令安装 + + 注意： + * 需要您确认您的 GPU 满足上方列出的要求 + + 如果您是使用 CUDA 8，cuDNN 7.1+，安装GPU版本的命令为： :: - pip install paddlepaddle-gpu==1.5.1.post97 - + conda install paddlepaddle-gpu cudatoolkit=8.0 - 如果您是使用 Python 2，CUDA 10.0，cuDNN 7.3+，安装GPU版本的命令为： + 如果您是使用 CUDA 9，cuDNN 7.3+，安装GPU版本的命令为： :: - pip install paddlepaddle-gpu==1.5.1.post107 + conda install paddlepaddle-gpu cudatoolkit=9.0 - 如果您是使用 Python 3，请将上述命令中的 `pip` 更换为 `pip3` 进行安装。 -7. 更多帮助信息请参考： - `Ubuntu下安装 `_ + 如果您是使用 CUDA 10.0，cuDNN 7.3+，安装GPU版本的命令为： + :: + + conda install paddlepaddle-gpu cudatoolkit=10.0 - `CentOS下安装 `_ +10. 验证安装 - `MacOS下安装 `_ + 使用 python 或 python3 进入python解释器，输入import paddle.fluid ，再输入 paddle.fluid.install_check.run_check()。 - `Windows下安装 `_ + 如果出现 Your Paddle Fluid is installed succesfully!，说明您已成功安装。 +11. 更多帮助信息请参考： + `conda下安装 `_ -第二种安装方式：使用 docker 安装 + +第三种安装方式：使用 docker 安装 ================================ -您可以选择“使用pip安装”、“使用docker安装”、“从源码编译安装” 三种方式中的任意一种方式进行安装。 +您可以选择“使用pip安装”、“使用conda安装”、“使用docker安装”、“从源码编译安装” 四种方式中的任意一种方式进行安装。 本节将介绍使用 `docker` 的安装方式。 @@ -239,14 +415,14 @@ * 您的计算机需要具有支持 `CUDA` 驱动的 `NVIDIA` 显卡 - * 需要安装 `cuDNN `_ ，版本要求 7.3+ + * 需要安装 `cuDNN `_ ，版本要求 7.3+(For CUDA9/10), 7.1+(For CUDA 8) * 如果您需要 GPU 多卡模式，需要安装 `NCCL 2 `_ * 仅 Ubuntu/CentOS 支持 NCCL 2 技术 * 需要安装 `CUDA `_，根据您系统不同，对 CUDA 版本要求不同： - * Ubuntu/CentOS 7 ，如果您是使用 `nvidia-docker` 安装，支持 CUDA 8/9/10.0 + * Ubuntu/CentOS 7 ，如果您是使用 `nvidia-docker` 安装，支持 CUDA 8.0/9.0/9.1/9.2/10.0 * Windows/MacOS/CentOS 6 不支持 `nvidia-docker` 方式安装 @@ -269,7 +445,7 @@ > hub.baidubce.com/paddlepaddle/paddle:1.5.1-gpu-cuda10.0-cudnn7 是需要使用的image名称；/bin/bash是在Docker中要执行的命令 - 或如果您需要支持 `CUDA 8` 或者 `CUDA 9` 的版本，将上述命令的 `cuda10.0` 替换成 `cuda8.0` 或者 `cuda9.0` 即可，cuDNN 仅支持 `cuDNN 7.3+` + 或如果您需要支持 `CUDA 8` 或者 `CUDA 9` 的版本，将上述命令的 `cuda10.0` 替换成 `cuda8.0` 或者 `cuda9.0` 即可 3. 如果您的机器不在中国大陆地区，可以直接从DockerHub拉取镜像： :: @@ -284,12 +460,18 @@ > paddlepaddle/paddle:1.5.1 是需要使用的image名称；/bin/bash是在Docker中要执行的命令 -4. 更多帮助信息请参考：`使用Docker安装 `_。 +4. 验证安装 + + 使用 python 或 python3 进入python解释器，输入import paddle.fluid ，再输入 paddle.fluid.install_check.run_check()。 + + 如果出现 Your Paddle Fluid is installed succesfully!，说明您已成功安装。 + +5. 更多帮助信息请参考：`使用Docker安装 `_。 -第三种安装方式：使用源代码编译安装 +第四种安装方式：使用源代码编译安装 ==================================== -- 如果您只是使用 `PaddlePaddle` ，建议从 `pip` 和 `docker` 两种安装方式中选取一种进行安装即可。 +- 如果您只是使用 `PaddlePaddle` ，建议从 `pip` 和 `conda` 、 `docker` 三种安装方式中选取一种进行安装即可。 - 如果您有开发PaddlePaddle的需求，请参考：`从源码编译 `_ .. toctree:: @@ -299,6 +481,7 @@ install_CentOS.md install_MacOS.md install_Windows.md + install_Conda.md install_Docker.md compile/fromsource.rst Tables.md diff --git a/doc/fluid/beginners_guide/install/install_CentOS.md b/doc/fluid/beginners_guide/install/install_CentOS.md index 28675da66..ac45e780c 100644 --- a/doc/fluid/beginners_guide/install/install_CentOS.md +++ b/doc/fluid/beginners_guide/install/install_CentOS.md @@ -3,15 +3,59 @@ ## 环境准备 * *CentOS 版本 (64 bit)* - * *CentOS 6 (GPU版本支持CUDA 9/10.0, 仅支持单卡)* - * *CentOS 7 (GPU版本支持CUDA 8/9/10.0, 其中CUDA 8仅支持单卡)* + * *CentOS 6 (GPU版本支持CUDA 8.0/9.0/9.1/9.2, 仅支持单卡)* + * *CentOS 7 (GPU版本支持CUDA 9.0/9.1/9.2/10.0, 其中CUDA 8.0仅支持单卡)* * *Python 版本 2.7.15+/3.5.1+/3.6/3.7 (64 bit)* * *pip 或 pip3 版本 9.0.1+ (64 bit)* ### 注意事项 * 可以使用`uname -m && cat /etc/*release`查看本机的操作系统和位数信息 -* 可以使用`pip -V`(Python版本为2.7)或`pip3 -V`(Python版本为3.5/3.6/3.7)，确认pip/pip3版本是否满足要求 +* 确认需要安装 PaddlePaddle 的 Python 是您预期的位置，因为您计算机可能有多个 Python + + * 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + which python + + * 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + which python3 + +* 需要确认python的版本是否满足要求 + + * 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ + + python --version + + * 如果您是使用 Python 3，使用以下命令确认是 3.5.1+/3.6/3.7 + + python3 --version + +* 需要确认pip的版本是否满足要求，要求pip版本为9.0.1+ + + * 如果您是使用 Python 2 + + python -m ensurepip + + python -m pip --version + + * 如果您是使用 Python 3 + + python3 -m ensurepip + + python3 -m pip --version + +* 需要确认Python和pip是64bit，并且处理器架构是x86_64（或称作x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是"64bit"，第二行输出的是"x86_64"、"x64"或"AMD64"即可： + + * 如果您是使用 Python 2 + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + + * 如果您是使用 Python 3 + + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + +* 默认提供的安装包需要计算机支持MKL * 如果您对机器环境不了解，请下载使用[快速安装脚本](https://fast-install.bj.bcebos.com/fast_install.sh)，配套说明请参考[这里](https://github.com/PaddlePaddle/FluidDoc/tree/develop/doc/fluid/beginners_guide/install/install_script.md)。 ## 选择CPU/GPU @@ -38,9 +82,10 @@ ## 安装方式 -CentOS系统下有4种安装方式： +CentOS系统下有5种安装方式： * pip安装（推荐） +* [conda安装](./install_Conda.html) * [Docker安装](./install_Docker.html) * [源码编译安装](./compile/compile_CentOS.html#ct_source) * [Docker源码编译安装](./compile/compile_CentOS.html#ct_docker) @@ -49,17 +94,17 @@ CentOS系统下有4种安装方式： ## 安装步骤 -* CPU版PaddlePaddle：`pip install -U paddlepaddle` 或 `pip3 install -U paddlepaddle` -* GPU版PaddlePaddle：`pip install -U paddlepaddle-gpu` 或 `pip3 install -U paddlepaddle-gpu` +* CPU版PaddlePaddle：`python -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` +* GPU版PaddlePaddle：`python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 您可[验证是否安装成功](#check)，如有问题请查看[FAQ](./FAQ.html) 注： -* pip与python版本对应。如果是python2.7, 建议使用`pip`命令; 如果是python3.x, 则建议使用`pip3`命令 +* 如果是python2.7, 建议使用`python`命令; 如果是python3.x, 则建议使用`python3`命令 -* `pip install -U paddlepaddle-gpu` 此命令将安装支持CUDA 10.0 cuDNN v7的PaddlePaddle，如您对CUDA或cuDNN版本有不同要求，可用`pip install -U paddlepaddle-gpu==[版本号]`或 `pip3 install -U paddlepaddle-gpu==[版本号]`命令来安装，版本号请见[这里](https://pypi.org/project/paddlepaddle-gpu/#history), 关于paddlepaddle与CUDA, cuDNN版本的对应关系请见[安装包列表](./Tables.html/#whls) +* `python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 此命令将安装支持CUDA 10.0 cuDNN v7的PaddlePaddle，如您对CUDA或cuDNN版本有不同要求，可用`python -m pip install paddlepaddle-gpu==[版本号] -i https://pypi.tuna.tsinghua.edu.cn/simple`或 `python3 -m pip install paddlepaddle-gpu==[版本号] -i https://pypi.tuna.tsinghua.edu.cn/simple`命令来安装，版本号请见[这里](https://pypi.org/project/paddlepaddle-gpu/#history), 关于paddlepaddle与CUDA, cuDNN版本的对应关系请见[安装包列表](./Tables.html/#whls) * 默认下载最新稳定版的安装包，如需获取开发版安装包，请参考[这里](./Tables.html/#ciwhls) @@ -74,6 +119,6 @@ CentOS系统下有4种安装方式： ## ***如何卸载*** 请使用以下命令卸载PaddlePaddle： -* ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` +* ***CPU版本的PaddlePaddle***: `python -m pip uninstall paddlepaddle` 或 `python3 -m pip uninstall paddlepaddle` -* ***GPU版本的PaddlePaddle***: `pip uninstall paddlepaddle-gpu` 或 `pip3 uninstall paddlepaddle-gpu` +* ***GPU版本的PaddlePaddle***: `python -m pip uninstall paddlepaddle-gpu` 或 `python3 -m pip uninstall paddlepaddle-gpu` diff --git a/doc/fluid/beginners_guide/install/install_Conda.md b/doc/fluid/beginners_guide/install/install_Conda.md new file mode 100644 index 000000000..b6a524d14 --- /dev/null +++ b/doc/fluid/beginners_guide/install/install_Conda.md @@ -0,0 +1,106 @@ +# **使用conda安装** + +[Anaconda](https://www.anaconda.com/)是一个免费开源的Python和R语言的发行版本，用于计算科学，Anaconda致力于简化包管理和部署。Anaconda的包使用软件包管理系统Conda进行管理。Conda是一个开源包管理系统和环境管理系统，可在Windows、macOS和Linux上运行。 + +## 环境准备 + +在进行PaddlePaddle安装之前请确保您的Anaconda软件环境已经正确安装。软件下载和安装参见Anaconda官网(https://www.anaconda.com/)。在您已经正确安装Anaconda的情况下请按照下列步骤安装PaddlePaddle。 + +## 安装步骤 + +1. 创建虚拟环境 + + 首先根据具体的Python版本创建Anaconda虚拟环境，前PaddlePaddle的Anaconda安装支持以下四种Python安装环境。 + + 如果您想使用的python版本为2.7: + + conda create -n paddle_env python=2.7 + + 如果您想使用的python版本为3.5: + + conda create -n paddle_env python=3.5 + + 如果您想使用的python版本为3.6: + + conda create -n paddle_env python=3.6 + + 如果您想使用的python版本为3.7: + + conda create -n paddle_env python=3.7 + + activate paddle_env (for Windows) 或 conda activate paddle_env (for MacOS/Linux) 命令进入Anaconda虚拟环境。 + +2. 确认您的conda虚拟环境和需要安装PaddlePaddle的Python是您预期的位置，因为您计算机可能有多个Python。进入Anaconda的命令行终端，输入以下指令确认Python位置。 + + 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + 在 Windows 环境下，输出 Python 路径的命令为： + + where python + + 在 MacOS/Linux 环境下，输出 Python 路径的命令为： + + which python + + 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + 在 Windows 环境下，输出 Python 路径的命令为： + + where python3 + + 在 MacOS/Linux 环境下，输出 Python 路径的命令为： + + which python3 + +3. 检查Python的版本 + + 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ + + python --version + + 如果您是使用 Python 3，使用以下命令确认是 3.5.1+/3.6/3.7 + + python3 --version + +4. 确认Python和pip是64bit，并且处理器架构是x86_64（或称作x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是"64bit"，第二行输出的是"x86_64（或x64、AMD64）"即可： + + 如果您是使用 Python 2 + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + + 如果您是使用 Python 3 + + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + +5. 安装PaddlePaddle + + (1). **CPU版本**：如果您只是想安装CPU版本请参考如下命令安装 + + conda install paddlepaddle + + (2). **GPU版本**：如果您想使用GPU版本请参考如下命令安装 + + 如果您是使用 CUDA 8，cuDNN 7.1+，安装GPU版本的命令为： + + conda install paddlepaddle-gpu cudatoolkit=8.0 + + 如果您是使用 CUDA 9，cuDNN 7.3+，安装GPU版本的命令为： + + conda install paddlepaddle-gpu cudatoolkit=9.0 + + 如果您是使用 CUDA 10.0，cuDNN 7.3+，安装GPU版本的命令为： + + conda install paddlepaddle-gpu cudatoolkit=10.0 + +6. 安装环境验证 + + 使用python进入python解释器，输入import paddle.fluid，再输入 paddle.fluid.install_check.run_check()。如果出现“Your Paddle Fluid is installed succesfully!”，说明您已成功安装。 + +## 注意 + +对于国内用户无法连接到Anaconda官方源的可以按照以下命令添加清华源进行安装。 + + conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ + conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/ + conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/Paddle/ + conda config --set show_channel_urls yes diff --git a/doc/fluid/beginners_guide/install/install_MacOS.md b/doc/fluid/beginners_guide/install/install_MacOS.md index 145ee5ae6..0b400608b 100644 --- a/doc/fluid/beginners_guide/install/install_MacOS.md +++ b/doc/fluid/beginners_guide/install/install_MacOS.md @@ -8,8 +8,51 @@ ### 注意事项 -* 可以使用`pip -V`(Python版本为2.7)或`pip3 -V`(Python版本为3.5/3.6/3.7)，确认pip/pip3版本是否满足要求 -* 默认提供的安装包需要计算机支持AVX指令集和MKL +* 确认需要安装 PaddlePaddle 的 Python 是您预期的位置，因为您计算机可能有多个 Python + + * 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + which python + + * 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + which python3 + +* 需要确认python的版本是否满足要求 + + * 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ + + python --version + + * 如果您是使用 Python 3，使用以下命令确认是 3.5.1+/3.6/3.7 + + python3 --version + +* 需要确认pip的版本是否满足要求，要求pip版本为9.0.1+ + + * 如果您是使用 Python 2 + + python -m ensurepip + + python -m pip --version + + * 如果您是使用 Python 3 + + python3 -m ensurepip + + python3 -m pip --version + +* 需要确认Python和pip是64bit，并且处理器架构是x86_64（或称作x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是"64bit"，第二行输出的是"x86_64"、"x64"或"AMD64"即可： + + * 如果您是使用 Python 2 + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + + * 如果您是使用 Python 3 + + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + +* 默认提供的安装包需要计算机支持MKL ## 选择CPU/GPU @@ -17,9 +60,10 @@ ## 安装方式 -MacOS系统下有4种安装方式： +MacOS系统下有5种安装方式： * pip安装（推荐） +* [conda安装](./install_Conda.html) * [Docker安装](./install_Docker.html) * [源码编译安装](./compile/compile_MacOS.html#mac_source) * [Docker源码编译安装](./compile/compile_MacOS.html#mac_docker) @@ -28,14 +72,14 @@ MacOS系统下有4种安装方式： ## 安装步骤 -* CPU版PaddlePaddle：`pip install -U paddlepaddle` 或 `pip3 install -U paddlepaddle` +* CPU版PaddlePaddle：`python -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` 您可[验证是否安装成功](#check)，如有问题请查看[FAQ](./FAQ.html) 注： * MacOS上您需要安装unrar以支持PaddlePaddle，可以使用命令`brew install unrar` -* pip与python版本对应。如果是python2.7, 建议使用`pip`命令; 如果是python3.x, 则建议使用`pip3`命令 +* 如果是python2.7, 建议使用`python`命令; 如果是python3.x, 则建议使用`python3`命令 * 默认下载最新稳定版的安装包，如需获取开发版安装包，请参考[这里](./Tables.html/#ciwhls) @@ -54,4 +98,4 @@ MacOS系统下有4种安装方式： 请使用以下命令卸载PaddlePaddle： -* `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` +* `python -m pip uninstall paddlepaddle` 或 `python3 -m pip uninstall paddlepaddle` diff --git a/doc/fluid/beginners_guide/install/install_Ubuntu.md b/doc/fluid/beginners_guide/install/install_Ubuntu.md index b579f7ea9..9acb4972a 100644 --- a/doc/fluid/beginners_guide/install/install_Ubuntu.md +++ b/doc/fluid/beginners_guide/install/install_Ubuntu.md @@ -3,8 +3,8 @@ ## 环境准备 * *Ubuntu 版本 (64 bit)* - * *Ubuntu 14.04 (GPU 版本支持 CUDA 8/10.0)* - * *Ubuntu 16.04 (GPU 版本支持 CUDA 8/9/10.0)* + * *Ubuntu 14.04 (GPU 版本支持 CUDA 8.0/10.0)* + * *Ubuntu 16.04 (GPU 版本支持 CUDA 8.0/9.0/9.1/9.2/10.0)* * *Ubuntu 18.04 (GPU 版本支持 CUDA 10.0)* * *Python 版本 2.7.15+/3.5.1+/3.6/3.7 (64 bit)* * *pip或pip3 版本 9.0.1+ (64 bit)* @@ -12,7 +12,51 @@ ### 注意事项 * 可以使用`uname -m && cat /etc/*release`查看本机的操作系统和位数信息 -* 可以使用`pip -V`(Python版本为2.7)或`pip3 -V`(Python版本为3.5/3.6/3.7)，确认pip/pip3版本是否满足要求 +* 确认需要安装 PaddlePaddle 的 Python 是您预期的位置，因为您计算机可能有多个 Python + + * 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + which python + + * 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + which python3 + +* 需要确认python的版本是否满足要求 + + * 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ + + python --version + + * 如果您是使用 Python 3，使用以下命令确认是 3.5.1+/3.6/3.7 + + python3 --version + +* 需要确认pip的版本是否满足要求，要求pip版本为9.0.1+ + + * 如果您是使用 Python 2 + + python -m ensurepip + + python -m pip --version + + * 如果您是使用 Python 3 + + python3 -m ensurepip + + python3 -m pip --version + +* 需要确认Python和pip是64bit，并且处理器架构是x86_64（或称作x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是"64bit"，第二行输出的是"x86_64"、"x64"或"AMD64"即可： + + * 如果您是使用 Python 2 + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + + * 如果您是使用 Python 3 + + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + +* 默认提供的安装包需要计算机支持MKL * 如果您对机器环境不了解，请下载使用[快速安装脚本](https://fast-install.bj.bcebos.com/fast_install.sh)，配套说明请参考[这里](https://github.com/PaddlePaddle/FluidDoc/tree/develop/doc/fluid/beginners_guide/install/install_script.md)。 ## 选择CPU/GPU @@ -39,9 +83,10 @@ ## 安装方式 -Ubuntu系统下有4种安装方式： +Ubuntu系统下有5种安装方式： * pip安装（推荐） +* [conda安装](./install_Conda.html) * [Docker安装](./install_Docker.html) * [源码编译安装](./compile/compile_Ubuntu.html#ubt_source) * [Docker源码编译安装](./compile/compile_Ubuntu.html#ubt_docker) @@ -50,19 +95,19 @@ Ubuntu系统下有4种安装方式： ## 安装步骤 -* CPU版PaddlePaddle：`pip install -U paddlepaddle` 或 `pip3 install -U paddlepaddle` +* CPU版PaddlePaddle：`python -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` -* GPU版PaddlePaddle：`pip install -U paddlepaddle-gpu` 或 `pip3 install -U paddlepaddle-gpu` +* GPU版PaddlePaddle：`python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 您可[验证是否安装成功](#check)，如有问题请查看[FAQ](./FAQ.html) 注： -* pip与python版本对应。如果是python2.7, 建议使用`pip`命令; 如果是python3.x, 则建议使用`pip3`命令 +* 如果是python2.7, 建议使用`python`命令; 如果是python3.x, 则建议使用`python3`命令 -* `pip install -U paddlepaddle-gpu` 此命令将安装支持CUDA 10.0 cuDNN v7的PaddlePaddle，如您对CUDA或cuDNN版本有不同要求，可用`pip install -U paddlepaddle-gpu==[版本号]`或 `pip3 install -U paddlepaddle-gpu==[版本号]`命令来安装，版本号请见[这里](https://pypi.org/project/paddlepaddle-gpu/#history)，关于paddlepaddle与CUDA, cuDNN版本的对应关系请见[安装包列表](./Tables.html/#whls) +* `python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 此命令将安装支持CUDA 10.0 cuDNN v7的PaddlePaddle，如您对CUDA或cuDNN版本有不同要求，可用`python -m pip install paddlepaddle-gpu==[版本号] -i https://pypi.tuna.tsinghua.edu.cn/simple`或 `python3 -m pip install paddlepaddle-gpu==[版本号] -i https://pypi.tuna.tsinghua.edu.cn/simple`命令来安装，版本号请见[这里](https://pypi.org/project/paddlepaddle-gpu/#history)，关于paddlepaddle与CUDA, cuDNN版本的对应关系请见[安装包列表](./Tables.html/#whls) * 默认下载最新稳定版的安装包，如需获取开发版安装包，请参考[这里](./Tables.html/#ciwhls) @@ -77,6 +122,6 @@ Ubuntu系统下有4种安装方式： ## 如何卸载 请使用以下命令卸载PaddlePaddle： -* ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` +* ***CPU版本的PaddlePaddle***: `python -m pip uninstall paddlepaddle` 或 `python3 -m pip uninstall paddlepaddle` -* ***GPU版本的PaddlePaddle***: `pip uninstall paddlepaddle-gpu` 或 `pip3 uninstall paddlepaddle-gpu` +* ***GPU版本的PaddlePaddle***: `python -m pip uninstall paddlepaddle-gpu` 或 `python3 -m pip uninstall paddlepaddle-gpu` diff --git a/doc/fluid/beginners_guide/install/install_Windows.md b/doc/fluid/beginners_guide/install/install_Windows.md index 0373a22e8..1ffd6b1eb 100644 --- a/doc/fluid/beginners_guide/install/install_Windows.md +++ b/doc/fluid/beginners_guide/install/install_Windows.md @@ -8,7 +8,51 @@ ### 注意事项 -* 默认提供的安装包需要计算机支持AVX指令集和MKL，如果您的环境不支持，请在[这里](./Tables.html/#ciwhls-release)下载`openblas`版本的安装包 +* 确认需要安装 PaddlePaddle 的 Python 是您预期的位置，因为您计算机可能有多个 Python + + * 如果您是使用 Python 2，使用以下命令输出 Python 路径，根据的环境您可能需要将说明中所有命令行中的 python 替换为具体的 Python 路径 + + where python + + * 如果您是使用 Python 3，使用以下命令输出 Python 路径，根据您的环境您可能需要将说明中所有命令行中的 python3 替换为 python 或者替换为具体的 Python 路径 + + where python3 + +* 需要确认python的版本是否满足要求 + + * 如果您是使用 Python 2，使用以下命令确认是 2.7.15+ + + python --version + + * 如果您是使用 Python 3，使用以下命令确认是 3.5.1+/3.6/3.7 + + python3 --version + +* 需要确认pip的版本是否满足要求，要求pip版本为9.0.1+ + + * 如果您是使用 Python 2 + + python -m ensurepip + + python -m pip --version + + * 如果您是使用 Python 3 + + python3 -m ensurepip + + python3 -m pip --version + +* 需要确认Python和pip是64bit，并且处理器架构是x86_64（或称作x64、Intel 64、AMD64）架构，目前PaddlePaddle不支持arm64架构。下面的第一行输出的是"64bit"，第二行输出的是"x86_64"、"x64"或"AMD64"即可： + + * 如果您是使用 Python 2 + + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + + * 如果您是使用 Python 3 + + python3 -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + +* 默认提供的安装包需要计算机支持MKL，如果您的环境不支持，请在[这里](./Tables.html/#ciwhls-release)下载`openblas`版本的安装包 * 当前版本暂不支持NCCL，分布式等相关功能 ## 选择CPU/GPU @@ -28,26 +72,26 @@ Windows系统下有3种安装方式： * pip安装（推荐） -* [Docker安装](./install_Docker.html) +* [conda安装](./install_Conda.html) * [源码编译安装](./compile/compile_Windows.html#win_source) 这里为您介绍pip安装方式 ## 安装步骤 -* CPU版PaddlePaddle：`pip install -U paddlepaddle` 或 `pip3 install -U paddlepaddle` +* CPU版PaddlePaddle：`python -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle -i https://pypi.tuna.tsinghua.edu.cn/simple` -* GPU版PaddlePaddle：`pip install -U paddlepaddle-gpu` 或 `pip3 install -U paddlepaddle-gpu` +* GPU版PaddlePaddle：`python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 或 `python3 -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 您可[验证是否安装成功](#check)，如有问题请查看[FAQ](./FAQ.html) 注： -* pip与python版本对应。如果是python2.7, 建议使用`pip`命令; 如果是python3.x, 则建议使用`pip3`命令 +* 如果是python2.7, 建议使用`python`命令; 如果是python3.x, 则建议使用`python3`命令 -* `pip3 install -U paddlepaddle-gpu` 此命令将安装支持CUDA 8.0/9.0 cuDNN v7.3+的PaddlePaddle，如您对CUDA或cuDNN版本有不同要求，可用`pip install -U paddlepaddle-gpu==[版本号]`或 `pip3 install -U paddlepaddle-gpu==[版本号]`命令来安装，版本号请见[这里](https://pypi.org/project/paddlepaddle-gpu/#history), 关于paddlepaddle与CUDA, cuDNN版本的对应关系请见[安装包列表](./Tables.html/#whls) +* `python -m pip install paddlepaddle-gpu -i https://pypi.tuna.tsinghua.edu.cn/simple` 此命令将安装支持CUDA 8.0/9.0 cuDNN v7.3+的PaddlePaddle，如您对CUDA或cuDNN版本有不同要求，可用`python -m pip install paddlepaddle-gpu==[版本号] -i https://pypi.tuna.tsinghua.edu.cn/simple`或 `python3 -m pip install paddlepaddle-gpu==[版本号] -i https://pypi.tuna.tsinghua.edu.cn/simple`命令来安装，版本号请见[这里](https://pypi.org/project/paddlepaddle-gpu/#history), 关于paddlepaddle与CUDA, cuDNN版本的对应关系请见[安装包列表](./Tables.html/#whls) @@ -59,6 +103,6 @@ Windows系统下有3种安装方式： ## 如何卸载 -* ***CPU版本的PaddlePaddle***: `pip uninstall paddlepaddle` 或 `pip3 uninstall paddlepaddle` +* ***CPU版本的PaddlePaddle***: `python -m pip uninstall paddlepaddle` 或 `python3 -m pip uninstall paddlepaddle` -* ***GPU版本的PaddlePaddle***: `pip uninstall paddlepaddle-gpu` 或 `pip3 uninstall paddlepaddle-gpu` +* ***GPU版本的PaddlePaddle***: `python -m pip uninstall paddlepaddle-gpu` 或 `python3 -m pip uninstall paddlepaddle-gpu` -- GitLab