关于Windows系统的一些使用建议

[TommysLee]

百度飞浆AI一站式工具最新版PaddleX3的详细安装教程，根据以下步骤，可以帮助大家避坑，且一次性安装成功，助力大家将复杂的AI环境搭建标准化、流程化、简单化。原来AI开发可以如此简单。话不多说，直接上干货。

环境准备

本教程的PaddleX3环境搭建，基于此软硬件环境，请大家参考，如若您的环境与此不同，请尽量调整一致。

• 操作系统：Windows 10/11 64位 家庭版 / 专业版
• GPU：Nvidia （需支持CUDA）
• CUDA版本：11.8
• CUDNN版本：8.9
• Python版本：3.10

注：请务必确认自己的Nvidia GPU是否支持CUDA11.8

如何确认GPU是否支持CUDA11.8

• 打开NVIDIA控制面板后，点击左下角的 “系统信息”
• 在弹出的画面中，点击 “组件”

注：只要这里显示的CUDA版本号 ≥ 11.8 即可。

安装步骤

严格按照下面的顺序流程，安装相关依赖与软件包，即可顺利完成PaddleX3的环境搭建。So Easy！

1、安装Microsoft C++编译器

下载连接：https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/

注：此处下载的是在线安装包，所以安装过程较长，请耐心等待...

在线安装包内部下载完安装包后，会弹出如下画面，请严格按如图勾选相关配置，保持一致。

否则在PaddleX编译时，会报错。（这是第1个坑）

2、安装CUDA 11.8

下载链接：https://developer.nvidia.com/cuda-11-8-0-download-archive?target_os=Windows&target_arch=x86_64&target_version=10&target_type=exe_local

• 双击安装，安装步骤如下图所示，相关选项，请与图中保持一致。

重要提示： 若电脑安装了360相关安全套件（如安全卫士、杀毒软件等），请在安装CUDA时，将其关闭，否则CUDA会安装失败。（第2个坑）

# 输入如下命令，验证CUDA是否安装成功
nvcc -V
 
# 输出如下内容，即安装成功
nvcc: NVIDIA (R) Cuda compiler driver
Copyright (c) 2005-2022 NVIDIA Corporation
Built on Wed_Sep_21_10:41:10_Pacific_Daylight_Time_2022
Cuda compilation tools, release 11.8, V11.8.89
Build cuda_11.8.r11.8/compiler.31833905_0

3、安装CUDNN

下载链接：https://developer.nvidia.com/rdp/cudnn-archive

注：下载cuDNN时，需要先登录Nvidia账号。

• cuDNN安装非常简单，采用解压安装的方式；
• 将下载的Zip压缩包，将其中的文件解压到CUDA安装的根目录，即安装完成。

4、安装miniConda

下载链接：https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe

注：点击链接下载最新版后，双击安装即可。

• 配置Conda国内源

（1）生成配置文件 .condarc （其位置在用户根目录下）

conda config --set show_channel_urls yes

（2）将如下内容，复制到用户目录下的 .condarc 文件中

channels:
  - defaults
show_channel_urls: true
default_channels:
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r
  - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2
custom_channels:
  conda-forge: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  msys2: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  bioconda: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  menpo: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  pytorch-lts: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  simpleitk: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud
  deepmodeling: https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/

（3）清除索引缓存，保证用的是镜像站提供的索引

conda clean -i

• 配置Pip国内源

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

• 查询conda配置信息

conda info

5、基于miniConda创建Python环境

• 创建python 3.10环境，并将其命名为paddlex

conda create -n paddlex python==3.10

• 切换到paddlex环境

conda activate paddlex

6、安装PaddlePaddle

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

使用以下命令可以验证 PaddlePaddle 是否安装成功。

python -c "import paddle; paddle.utils.run_check()"

查看 PaddlePaddle 版本的命令如下：

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

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

3.0.0-beta1

7、安装PaddleX

7-1、从 Github clone 源码

git clone -b release/3.0-beta https://github.com/PaddlePaddle/PaddleX.git

7-2、安装配置及依赖

• 安装前置依赖，否则在编译paddlex时，会报权限错误（第3个坑）

cd PaddleX
 
# 安装依赖
python -m pip install --upgrade pip
pip install opencv-contrib-python==4.6.0.66 --user

• 安装 PaddleX whl

# -e：以可编辑模式安装，当前项目的代码更改，都会直接作用到已经安装的 PaddleX Wheel
pip install -e .

• 安装 PaddleX 相关依赖

# 安装命令
paddlex --install

# 国内用此命令加速
paddlex --install --platform gitee.com

• 完成安装后会有如下提示，表示PaddleX安装成功

All packages are installed.

使用PaddleX的模型进行AI推理

paddlex --pipeline object_detection \    
  --model PP-YOLOE_plus-S \    
  --input \    
  https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/fall.png

输出结果如下：

The device id has been set to 0.
Connecting to https://paddle-model-ecology.bj.bcebos.com/paddlex/official_inference_model/paddle3.0/PP-YOLOE_plus-S_infer.tar ...
Downloading PP-YOLOE_plus-S_infer.tar ...
[==================================================] 100.00%
Extracting PP-YOLOE_plus-S_infer.tar
[==================================================] 100.00%
Transformation operators for data preprocessing will be inferred from config file.
Connecting to https://paddle-model-ecology.bj.bcebos.com/paddlex/imgs/demo_image/fall.png ...
Downloading fall.png ...
[==================================================] 100.00%
The prediction result is:
[[   0.            0.965981    536.0723      565.9951     1624.9193
  1021.6263    ]
 [   0.            0.96458614  536.94745     131.15625    1133.9929
   874.8963    ]
 [   0.            0.9512729   161.86955      78.24556     537.0509
   935.6451    ]
 ...
 [  39.            0.01868815  437.38864     420.06418     535.0598
   497.7409    ]
 [  39.            0.01868636  543.26215     873.67395     619.9371
   939.1802    ]
 [  65.            0.01868468  450.03323     419.4944      490.1303
   443.73993   ]]

至此，PaddleX完全安装完毕！

Enjoy It！

[cuicheng01]

怒赞！👍🏻👍🏻

[TommysLee]

近期安装 PaddleX3-beta 会出现此错误：

Now download and update the repos: ['PaddleOCR', 'PaddleSeg', 'PaddleNLP', 'PaddleDetection', 'PaddleClas', 'PaddleTS'].
Traceback (most recent call last):
  File "\\?\C:\DevTools\miniconda\envs\px3\Scripts\paddlex-script.py", line 33, in <module>
    sys.exit(load_entry_point('paddlex', 'console_scripts', 'paddlex')())
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\paddlex_cli.py", line 109, in main
    install(args)
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\paddlex_cli.py", line 85, in install
    setup(
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\repo_manager\core.py", line 183, in setup
    getter.get(force=True, platform=platform)
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\repo_manager\repo.py", line 386, in get
    self.remove()
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\repo_manager\repo.py", line 394, in remove
    repo.remove()
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\repo_manager\repo.py", line 152, in remove
    remove_repo_using_rm(self.name)
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\repo_manager\utils.py", line 104, in remove_repo_using_rm
    return _check_call(['rm', '-rf', name])
  File "c:\users\easygrid\desktop\temp\paddlex\paddlex\repo_manager\utils.py", line 25, in _check_call
    return subprocess.check_call(*args, **kwargs)
  File "C:\DevTools\miniconda\envs\px3\lib\subprocess.py", line 364, in check_call
    retcode = call(*popenargs, **kwargs)
  File "C:\DevTools\miniconda\envs\px3\lib\subprocess.py", line 345, in call
    with Popen(*popenargs, **kwargs) as p:
  File "C:\DevTools\miniconda\envs\px3\lib\subprocess.py", line 966, in __init__
    self._execute_child(args, executable, preexec_fn, close_fds,
  File "C:\DevTools\miniconda\envs\px3\lib\subprocess.py", line 1435, in _execute_child
    hp, ht, pid, tid = _winapi.CreateProcess(executable, args,
FileNotFoundError: [WinError 2] 系统找不到指定的文件。

原因不明，不知是OS问题，还是PaddleX3问题。

大家如遇到，可参照如下方法解决：

打开此文件：PaddleX/paddlex/repo_manager/core.py

将183行的 force=True 修改为 force=False”

修改后core.py源码如下：

if len(repos_to_get) > 0:
    logging.info(
        f"Now download and update the repos: {list(repo.name for repo in repos_to_get)}."
    )
    getter.get(force=False, platform=platform) # Line 183
    logging.info("All repos are existing.")

再次执行 paddlex --install 即可成功安装。

【提醒】执行安装前，请确保此目录是空的 PaddleX/paddlex/repo_manager/repos