PaddleClas/docs/zh_CN/tutorials/install.md

84 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 安装说明
---
## 一、简介
本章将介绍如何安装PaddleClas及其依赖项。
## 二、安装PaddlePaddle
运行PaddleClas需要`PaddlePaddle 2.0rc1`或更高版本。请参照[安装文档](http://www.paddlepaddle.org.cn/install/quick)中的说明进行操作。
### 通过pip安装PaddlePaddle
如果已经安装好了cuda、cudnn、nccl或者安装好了docker、nvidia-docker运行环境可以pip安装最新GPU版本PaddlePaddle
```bash
pip install paddlepaddle-gpu==2.0.0rc1 --upgrade
```
如果希望在CPU环境中使用PaddlePaddle可以运行下面的命令安装PaddlePaddle。
```bash
pip install paddlepaddle==2.0.0rc1 --upgrade
```
### 源码编译PaddlePaddle
您也可以从源码编译安装PaddlePaddle请参照[安装文档](http://www.paddlepaddle.org.cn/install/quick)中的说明进行操作。
使用以下命令可以验证PaddlePaddle是否安装成功。
```python
import paddle
paddle.utils.run_check()
```
查看PaddlePaddle版本的命令如下
```bash
python -c "import paddle; print(paddle.__version__)"
```
注意:
- 从源码编译的PaddlePaddle版本号为0.0.0请确保使用了PaddlePaddle 2.0rc1及之后的源码编译。
- PaddleClas基于PaddlePaddle高性能的分布式训练能力若您从源码编译请确保打开编译选项**WITH_DISTRIBUTE=ON**。具体编译选项参考[编译选项表](https://www.paddlepaddle.org.cn/documentation/docs/zh/develop/install/Tables.html#id3)。
- 在docker中运行时为保证docker容器有足够的共享内存用于Paddle的数据读取加速在创建docker容器时请设置参数`--shm_size=8g`,条件允许的话可以设置为更大的值。
**运行环境需求:**
- Python3
- CUDA >= 9.0
- cuDNN >= 7.6.4
- nccl >= 2.1.2
## 三、安装PaddleClas
**克隆PaddleClas模型库**
```
cd path_to_clone_PaddleClas
git clone https://github.com/PaddlePaddle/PaddleClas.git
```
**安装Python依赖库**
Python依赖库在[requirements.txt](https://github.com/PaddlePaddle/PaddleClas/blob/master/requirements.txt)中给出,可通过如下命令安装:
```
pip install --upgrade -r requirements.txt
```
visualdl可能出现安装失败请尝试
```
pip3 install --upgrade visualdl==2.0.0b3 -i https://mirror.baidu.com/pypi/simple
```
此外visualdl目前只支持在python3下运行因此如果希望使用visualdl需要使用python3。