飞桨PaddlePaddle本地安装教程

源码下载：https://github.com/PaddlePaddle/PaddleX/blob/release/3.0-beta1/docs/installation/paddlepaddle_install.md

安装飞桨 PaddlePaddle 时，支持通过 Docker 安装和通过 pip 安装。

1-1. 基于 Docker 安装飞桨

若您通过 Docker 安装，请参考下述命令，使用飞桨官方 Docker 镜像，创建一个名为 paddlex 的容器，并将当前工作目录映射到容器内的 /paddle 目录：

• 若您使用的 Docker 版本 >= 19.03，请执行：

# 对于 cpu 用户:
docker run --name paddlex -v $PWD:/paddle --shm-size=8G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0b1 /bin/bash

# 对于 gpu 用户:
# CUDA11.8 用户
docker run --gpus all --name paddlex -v $PWD:/paddle --shm-size=8G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda11.8-cudnn8.6-trt8.5 /bin/bash

# CUDA12.3 用户
docker run --gpus all --name paddlex -v $PWD:/paddle --shm-size=8G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda12.3-cudnn9.0-trt8.6 /bin/bash

• 若您使用的 Docker 版本 <= 19.03 但 >= 17.06，请执行：

# 对于 cpu 用户:
docker run --name paddlex -v $PWD:/paddle --shm-size=8G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0b1 /bin/bash

# 对于 gpu 用户:
# CUDA11.8 用户
nvidia-docker run --name paddlex -v $PWD:/paddle --shm-size=8G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda11.8-cudnn8.6-trt8.5 /bin/bash

# CUDA12.3 用户
nvidia-docker run --name paddlex -v $PWD:/paddle --shm-size=8G --network=host -it ccr-2vdh3abv-pub.cnc.bj.baidubce.com/paddlepaddle/paddle:3.0.0b1-gpu-cuda12.3-cudnn9.0-trt8.6 /bin/bash

• 若您使用的 Docker 版本 <= 17.06，请升级 Docker 版本。

注：更多飞桨官方 docker 镜像请参考飞桨官网。

1-2. 基于 pip 安装飞桨

若您通过 pip 安装，请参考下述命令，用 pip 在当前环境中安装飞桨 PaddlePaddle：

# cpu
python -m pip install paddlepaddle==3.0.0b1 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

# gpu，该命令仅适用于 CUDA 版本为 11.8 的机器环境
python -m pip install paddlepaddle-gpu==3.0.0b1 -i https://www.paddlepaddle.org.cn/packages/stable/cu118/

# gpu，该命令仅适用于 CUDA 版本为 12.3 的机器环境
python -m pip install paddlepaddle-gpu==3.0.0b1 -i https://www.paddlepaddle.org.cn/packages/stable/cu123/

❗ 注：更多飞桨 Wheel 版本请参考飞桨官网。

关于其他硬件安装飞桨，请参考PaddleX多硬件使用指南。

安装完成后，使用以下命令可以验证 PaddlePaddle 是否安装成功：

python -c "import paddle; print(paddle.__version__)"

如果已安装成功，将输出以下内容：

3.0.0-beta1

2. 我两个环境 都选择的是pip 安装

windows11 肯定是CPU

# cpu
python -m pip install paddlepaddle==3.0.0b1 -i https://www.paddlepaddle.org.cn/packages/stable/cpu/

Ubuntu24.04 配备了 4090d显卡，用显存GPU== 显卡内存

## 而且是coda123
(base) root@hostname:~# python -m pip install paddlepaddle-gpu==3.0.0b1 -i https://www.paddlepaddle.org.cn/packages/stable/cu123/

10. 如果报错

Traceback (most recent call last):
  File "<string>", line 1, in <module>
  File "D:\Users\wang\PycharmProjects\github\ltkj-aiseek\seek_backend_py\.venv\Lib\site-packages\paddle\__init__.py", line 33, in <module>
    from .base import core  # noqa: F401
    ^^^^^^^^^^^^^^^^^^^^^^
  File "D:\Users\wang\PycharmProjects\github\ltkj-aiseek\seek_backend_py\.venv\Lib\site-packages\paddle\base\__init__.py", line 38, in <module>
    from . import (  # noqa: F401
  File "D:\Users\wang\PycharmProjects\github\ltkj-aiseek\seek_backend_py\.venv\Lib\site-packages\paddle\base\dataset.py", line 21, in <module>
    from ..utils import deprecated
  File "D:\Users\wang\PycharmProjects\github\ltkj-aiseek\seek_backend_py\.venv\Lib\site-packages\paddle\utils\__init__.py", line 16, in <module>
    from . import (  # noqa: F401
  File "D:\Users\wang\PycharmProjects\github\ltkj-aiseek\seek_backend_py\.venv\Lib\site-packages\paddle\utils\cpp_extension\__init__.py", line 15, in <module>
    from .cpp_extension import (
  File "D:\Users\wang\PycharmProjects\github\ltkj-aiseek\seek_backend_py\.venv\Lib\site-packages\paddle\utils\cpp_extension\cpp_extension.py", line 21, in <module>
    import setuptools
ModuleNotFoundError: No module named 'setuptools'

这个错误 pip._vendor.pyproject_hooks._impl.BackendUnavailable: Cannot import ‘setuptools.build_meta’ 通常表示在安装 Python 包时，pip 无法导入 setuptools.build_meta 模块，这可能是由于 setuptools 安装不完整或版本问题导致的。以下是一些可以尝试的解决方法：

1. 升级 setuptools：
   使用 pip 命令升级 setuptools 到最新版本，在命令行中运行：

   pip install --upgrade setuptools
   

   然后再尝试安装之前失败的包（例如 paddlex）。

2. 重新安装 setuptools：
   先卸载当前的 setuptools，然后重新安装。在命令行中依次运行：

   pip uninstall setuptools
   pip install setuptools
   

   之后再次尝试安装你需要的包。
   

10. 离线安装

有线pypi包，可以通过Pypi官网 下载后，本地离线安装。
你可以在 PyPI 网站 上查看 setuptools 的可用版本，选择一个合适的版本进行安装。
按照以上步骤逐一尝试，应该能够解决 Cannot import ‘setuptools.build_meta’ 的问题，使你能够成功安装所需的 Python 包。