From cac878a659f2d156d1044d46c6ae61980e4609a7 Mon Sep 17 00:00:00 2001 From: tianshuo78520a <707759223@qq.com> Date: Wed, 23 Apr 2025 02:16:02 +0000 Subject: [PATCH 1/4] Update en install index --- docs/install/index_en.rst | 215 +++++++++++--------------------------- 1 file changed, 63 insertions(+), 152 deletions(-) diff --git a/docs/install/index_en.rst b/docs/install/index_en.rst index 4242a6e8d1f..71895bba16f 100644 --- a/docs/install/index_en.rst +++ b/docs/install/index_en.rst @@ -9,8 +9,7 @@ Important updates ---------------------- -* Add support for python3.12, and no longer supports python3.7 -* Add support for CUDA 12.0, and no longer supports CUDA 10.2 +* Paddle supports user installation without depending on CUDA and cuDNN, and automatically handles the installation of CUDA and cuDNN. ------------------------ @@ -23,10 +22,10 @@ The manuals will guide you to build and install PaddlePaddle on your 64-bit desk 1. Operating system requirements: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -* Windows 7 / 8 / 10, Pro/Enterprise -* Ubuntu 18.04 / 20.04 -* CentOS 7 -* macOS 10.x/11.x/12.x/13.x/14.x +* Windows 7 / 8 / 10 / 11, Pro/Enterprise +* Ubuntu 20.04 / 22.04 +* almalinux 8 +* macOS 12.x/13.x/14.x/15.x * 64-bit operating system is required 2. Processor requirements: @@ -38,188 +37,100 @@ The manuals will guide you to build and install PaddlePaddle on your 64-bit desk 3. Version requirements of python and pip: >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> -* Python requires version 3.8/3.9/3.10/3.11/3.12 +* Python requires version 3.8/3.9/3.10/3.11/3.12/3.13 * Python needs pip, and pip requires version 20.2.2 or above * Python and pip requires 64-bit -4. PaddlePaddle's support for GPU: ->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> +**First Installation Method: Using pip for installation** +You can choose any of the four methods: "Using pip for installation", "Using conda for installation", "Using docker for installation", "Compiling from source code for installation". -* Currently, **PaddlePaddle** supports **CUDA** driver of **NVIDIA** graphics card and **ROCm** driver of **AMD** card. -* You need to install `cuDNN `_ , and version 7.6+ is required(For CUDA11) -* If you need GPU multi-card mode, you need to install `NCCL 2 `_ +This section will introduce the installation method using pip. - * Only Ubuntu/CentOS support NCCL 2 -* You need to install `CUDA `_ , depending on your system, there are different requirements for CUDA version: +1.You need to ensure that your operating system meets the requirements listed above. - * Windows install GPU version +2.You need to ensure that your processor meets the requirements listed above. - * Windows 7 / 8 / 10 support CUDA 11.0/11.2/11.6/11.8/12.0 single-card mode - * don't support install using **nvidia-docker** - * Ubuntu install GPU version +3.Ensure that the Python where you need to install PaddlePaddle is in your expected location, as your computer may have multiple Pythons. - * Ubuntu 18.04 supports CUDA (11.0 - 12.0) - * Ubuntu 20.04 supports CUDA (11.0 - 12.0) - * If you install using **nvidia-docker** , it supports CUDA 11.2/11.7/12.0 - * CentOS install GPU version + Use the following command to output the Python path, depending on your environment you may need to replace all the python in the command line in the instructions with the specific Python path. - * If you install using native **pip** : + In the Windows environment, the command to output the Python path is: - * CentOS 7 supports CUDA (11.0 - 12.0) - * If you compile and install using native source code: + :: - * CentOS 7 supports CUDA (11.0 - 12.0) - * If you install using **nvidia-docker** , CentOS 7 supports CUDA 11.2/11.7/12.0 - * macOS isn't supported: PaddlePaddle has no GPU support in Mac OS platform + where python -Please make sure your environment meets the above conditions. If you have other requirements, please refer to `Appendix `_ . + In the macOS/Linux environment, the command to output the Python path is: -5. PaddlePaddle's support for NCCL: ->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> + :: -* Support for Windows + which python - * not support NCCL -* Support for Ubuntu +4.Check the Python version - * Ubuntu 18.04: - - * support NCCL v2.4.7 / v2.16.5 under CUDA11 - * Ubuntu 20.04: - - * support v2.4.7 / 2.16.5 under CUDA11 -* Support for CentOS - - * CentOS 7: - - * support NCCL v2.4.7-v2.16.5 under CUDA11 -* Support for macOS - - * not support NCCL - - -The first way to install: use pip to install ->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> - -You can choose any of the four ways to install: "use pip to install", "use Conda to install", "use Docker to install", "compiling from the source code" - -This section describes how to use pip to install. - -1. You need to confirm that your operating system meets the requirements listed above - -2. You need to confirm that your processor meets the requirements listed above - -3. 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 your environment, you may need to replace Python in all command lines in the description with specific Python path - - In the Windows environment, the command to output Python path is: - - :: - - where python - - In the macOS/Linux environment, the command to output Python path is: - - :: - - which python - - -4. Check the version of Python - - Confirm the Python is 3.8/3.9/3.10/3.11/3.12 using command + Use the following command to confirm it is 3.8/3.9/3.10/3.11/3.12/3.13 :: - python --version -5. Check the version of pip and confirm it is 20.2.2 or above - - :: - - python -m ensurepip - python -m pip --version - - -6. Confirm that Python and pip is 64 bit，and the processor architecture is x86_64(or called x64、Intel 64、AMD64)architecture. Currently. 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())" - - -7. If you want to use `pip `_ to install PaddlePaddle, you can use the command below directly: - - (1). **CPU version** : If you only want to install CPU version, please refer to command below - - Command to install CPU version is: - :: - - python -m pip install paddlepaddle==2.6.0 -i https://mirror.baidu.com/pypi/simple - - or - - python -m pip install paddlepaddle==2.6.0 -i https://pypi.tuna.tsinghua.edu.cn/simple - - - (2). **GPU version** : If you only want to install GPU version, please refer to command below - - - Note: - - * You need to confirm that your GPU meets the requirements listed above - - :: - - python -m pip install paddlepaddle-gpu==2.6.0 -i https://mirror.baidu.com/pypi/simple - - or - - python -m pip install paddlepaddle-gpu==2.6.0 -i https://pypi.tuna.tsinghua.edu.cn/simple - +5.Check the pip version, confirm it is 20.2.2+ + :: + python -m ensurepip + python -m pip --version - 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 Python 3 or specific Python path. +6.Confirm that Python and pip are 64 bit, and the processor architecture is x86_64 (also known as x64, Intel 64, AMD64). The first line of the following output is "64bit", and the second line output is "x86_64", "x64" or "AMD64": + :: + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" -8. Verify installation +7.If you want to use pip _ to install PaddlePaddle, you can directly use the following command: + Note: + * If you want to install paddlepaddle, the version requires libstdc++.so.6 version greater than 3.4.25. To meet this requirement, you can choose to install GCC 8 or a higher GCC version, or upgrade the libstdc++ library separately. * - After the installation is complete, you can use `python` to enter the Python interpreter and then use `import paddle` and then `paddle.utils.run_check()` to verify that the installation was successful. + (1). **CPU version**: If you just want to install the CPU version, please refer to the following command for installation + The command to install the CPU version is: + :: + python -m pip install --pre paddlepaddle -i https://www.paddlepaddle.org.cn/packages/nightly/cpu/ - If `PaddlePaddle is installed successfully!` appears, it means the installation was successful. + (2). GPU version: If you want to use the GPU version, please refer to the following command for installation + The command to install the GPU cuda12.6 version is: + :: + python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu126/ + The command to install the GPU cuda11.8 version is: + :: + python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu118/ -9. For more information to help, please refer to: + Please make sure that the Python where you need to install PaddlePaddle is in the expected location, as your computer may have multiple Pythons. Depending on your environment, you may need to replace all python in the command line in the instructions with the specific Python path. - `install under Ubuntu `_ +8.Verify the installation - `install under macOS `_ + Use python to enter the python interpreter, enter import paddle, then enter paddle.utils.run_check(). - `install under Windows `_ + If PaddlePaddle is installed successfully! appears, it means you have successfully installed. +9.For more help information, please refer to: + `PIP Installation under Linux `_ -The second way to install: compile and install with container ->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> + `PIP Installation under macOS `_ -- We recommend that you use `NVIDIA PaddlePaddle Container `_ for your development environment installation. -- Pros - 1. Lastest version of CUDA - 2. Newer verison of Ubuntu OS(18.04) - 3. Performance and development efficiency have been optimized by NVIDIA + `PIP Installation under Windows `_ + **Second Installation Method: Using Source Code Compilation for Installation** -The third way to install: compile and install with source code ->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> + - If you are just using PaddlePaddle, it is recommended to use **pip** for installation. -- If you use PaddlePaddle only, we suggest you installation methods **pip** to install. -- If you need to develop PaddlePaddle, please refer to `compile from source code `_ + - If you have a need to develop PaddlePaddle, please refer to: `Compiling from Source `_ .. toctree:: :hidden: - pip/frompip_en.rst - conda/fromconda_en.rst - docker/fromdocker_en.rst - compile/fromsource_en.rst - install_xpu_en.md - install_NGC_PaddlePaddle_en.rst - Tables_en.md + pip/frompip.rst + conda/fromconda.rst + docker/fromdocker.rst + compile/fromsource.rst + install_xpu_cn.md + install_dcu_cn.md + install_npu_cn.md + install_mlu_cn.md + install_NGC_PaddlePaddle_ch.rst + Tables.md From 36e0562ae6c24b16d0c5824bff3d070c1ad3b1a6 Mon Sep 17 00:00:00 2001 From: tianshuo78520a <707759223@qq.com> Date: Wed, 23 Apr 2025 02:57:08 +0000 Subject: [PATCH 2/4] Update --- docs/install/index_en.rst | 25 +++++++++++++------------ 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/install/index_en.rst b/docs/install/index_en.rst index 71895bba16f..8589d0886b6 100644 --- a/docs/install/index_en.rst +++ b/docs/install/index_en.rst @@ -69,28 +69,33 @@ This section will introduce the installation method using pip. 4.Check the Python version Use the following command to confirm it is 3.8/3.9/3.10/3.11/3.12/3.13 + :: python --version 5.Check the pip version, confirm it is 20.2.2+ + :: python -m ensurepip python -m pip --version 6.Confirm that Python and pip are 64 bit, and the processor architecture is x86_64 (also known as x64, Intel 64, AMD64). The first line of the following output is "64bit", and the second line output is "x86_64", "x64" or "AMD64": + :: python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" 7.If you want to use pip _ to install PaddlePaddle, you can directly use the following command: + Note: + * If you want to install paddlepaddle, the version requires libstdc++.so.6 version greater than 3.4.25. To meet this requirement, you can choose to install GCC 8 or a higher GCC version, or upgrade the libstdc++ library separately. * - (1). **CPU version**: If you just want to install the CPU version, please refer to the following command for installation + (1). **CPU version** : If you just want to install the CPU version, please refer to the following command for installation The command to install the CPU version is: :: python -m pip install --pre paddlepaddle -i https://www.paddlepaddle.org.cn/packages/nightly/cpu/ - (2). GPU version: If you want to use the GPU version, please refer to the following command for installation + (2). **GPU version** : If you want to use the GPU version, please refer to the following command for installation The command to install the GPU cuda12.6 version is: :: python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu126/ @@ -124,13 +129,9 @@ This section will introduce the installation method using pip. .. toctree:: :hidden: - pip/frompip.rst - conda/fromconda.rst - docker/fromdocker.rst - compile/fromsource.rst - install_xpu_cn.md - install_dcu_cn.md - install_npu_cn.md - install_mlu_cn.md - install_NGC_PaddlePaddle_ch.rst - Tables.md + pip/frompip_en.rst + conda/fromconda_en.rst + docker/fromdocker_en.rst + compile/fromsource_en.rst + install_NGC_PaddlePaddle_en.rst + Tables_en.md From f541e7b663248f8691ef9aa3fa506b3db56000b3 Mon Sep 17 00:00:00 2001 From: tianshuo78520a <707759223@qq.com> Date: Wed, 23 Apr 2025 06:21:54 +0000 Subject: [PATCH 3/4] Update --- docs/install/index_en.rst | 34 ++++++++++++++++++---------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/docs/install/index_en.rst b/docs/install/index_en.rst index 8589d0886b6..c936e165378 100644 --- a/docs/install/index_en.rst +++ b/docs/install/index_en.rst @@ -75,14 +75,14 @@ This section will introduce the installation method using pip. 5.Check the pip version, confirm it is 20.2.2+ - :: - python -m ensurepip - python -m pip --version + :: + python -m ensurepip + python -m pip --version 6.Confirm that Python and pip are 64 bit, and the processor architecture is x86_64 (also known as x64, Intel 64, AMD64). The first line of the following output is "64bit", and the second line output is "x86_64", "x64" or "AMD64": - :: - python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" + :: + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" 7.If you want to use pip _ to install PaddlePaddle, you can directly use the following command: @@ -90,19 +90,21 @@ This section will introduce the installation method using pip. * If you want to install paddlepaddle, the version requires libstdc++.so.6 version greater than 3.4.25. To meet this requirement, you can choose to install GCC 8 or a higher GCC version, or upgrade the libstdc++ library separately. * - (1). **CPU version** : If you just want to install the CPU version, please refer to the following command for installation - The command to install the CPU version is: - :: - python -m pip install --pre paddlepaddle -i https://www.paddlepaddle.org.cn/packages/nightly/cpu/ + (1). **CPU version** : If you just want to install the CPU version, please refer to the following command for installation + + The command to install the CPU version is: + :: + python -m pip install --pre paddlepaddle -i https://www.paddlepaddle.org.cn/packages/nightly/cpu/ + + (2). **GPU version** : If you want to use the GPU version, please refer to the following command for installation - (2). **GPU version** : If you want to use the GPU version, please refer to the following command for installation - The command to install the GPU cuda12.6 version is: - :: - python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu126/ + The command to install the GPU cuda12.6 version is: + :: + python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu126/ - The command to install the GPU cuda11.8 version is: - :: - python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu118/ + The command to install the GPU cuda11.8 version is: + :: + python -m pip install --pre paddlepaddle-gpu -i https://www.paddlepaddle.org.cn/packages/nightly/cu118/ Please make sure that the Python where you need to install PaddlePaddle is in the expected location, as your computer may have multiple Pythons. Depending on your environment, you may need to replace all python in the command line in the instructions with the specific Python path. From b9c1c4281336d80b0a70177ec517a4dd79d36eeb Mon Sep 17 00:00:00 2001 From: tianshuo78520a <707759223@qq.com> Date: Wed, 23 Apr 2025 08:02:34 +0000 Subject: [PATCH 4/4] Update --- docs/install/index_en.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/install/index_en.rst b/docs/install/index_en.rst index c936e165378..431ef2e88c3 100644 --- a/docs/install/index_en.rst +++ b/docs/install/index_en.rst @@ -71,17 +71,20 @@ This section will introduce the installation method using pip. Use the following command to confirm it is 3.8/3.9/3.10/3.11/3.12/3.13 :: + python --version 5.Check the pip version, confirm it is 20.2.2+ :: + python -m ensurepip python -m pip --version 6.Confirm that Python and pip are 64 bit, and the processor architecture is x86_64 (also known as x64, Intel 64, AMD64). The first line of the following output is "64bit", and the second line output is "x86_64", "x64" or "AMD64": :: + python -c "import platform;print(platform.architecture()[0]);print(platform.machine())" 7.If you want to use pip _ to install PaddlePaddle, you can directly use the following command: