PaddleNLP 安装指南：从基础环境到多平台部署

PaddleNLP 安装指南：从基础环境到多平台部署

PaddleNLP 👑 Easy-to-use and powerful NLP and LLM library with 🤗 Awesome model zoo, supporting wide-range of NLP tasks from research to industrial applications, including 🗂Text Classification, 🔍 Neural Search, ❓ Question Answering, ℹ️ Information Extraction, 📄 Document Intelligence, 💌 Sentiment Analysis etc. 项目地址: https://gitcode.com/gh_mirrors/pa/PaddleNLP

前言

PaddleNLP 作为基于 PaddlePaddle 深度学习框架的自然语言处理工具库，为开发者提供了丰富的预训练模型和便捷的 NLP 任务处理能力。本文将详细介绍 PaddleNLP 的多种安装方式，帮助不同需求的用户快速搭建开发环境。

环境准备

在安装 PaddleNLP 之前，必须确保已正确安装 PaddlePaddle 框架。PaddleNLP 需要 PaddlePaddle 3.0 或更高版本作为基础运行环境。

PaddlePaddle 安装建议

对于 GPU 用户，建议根据 CUDA 版本选择对应的安装包：

# CUDA 11.8 环境
python -m pip install paddlepaddle-gpu==3.0.0rc1

# CUDA 12.3 环境
python -m pip install paddlepaddle-gpu==3.0.0rc1

CPU 用户可以直接安装标准版 PaddlePaddle：

python -m pip install paddlepaddle

标准安装方法

pip 直接安装

这是最简单快捷的安装方式，适合大多数用户：

pip install --upgrade --pre paddlenlp==3.0.0b4

该命令会自动安装 PaddleNLP 及其所有依赖项。--upgrade 参数确保升级现有安装，--pre 允许安装预发布版本。

使用 Conda 环境安装

对于需要隔离开发环境的用户，推荐使用 Anaconda 或 Miniconda 进行管理。

Windows 平台

1. 安装 Conda：

   • 下载并运行 Anaconda 或 Miniconda 的 Windows 64 位安装程序
   • 按照向导完成安装

2. 创建专用环境：

   conda create -n my_paddlenlp python=3.9
   conda activate my_paddlenlp
   

3. 安装 PaddleNLP：

   pip install --upgrade --pre paddlenlp
   

Linux/Mac 平台

1. 安装 Conda：

   • 下载对应系统的安装脚本
   • 在终端中运行安装脚本

2. 环境配置：

   conda create -n paddlenlp_env python=3.9
   conda activate paddlenlp_env
   pip install --upgrade --pre paddlenlp
   

源码编译安装

对于需要定制开发或参与贡献的高级用户，可以从源码安装：

1. 获取源码：

   git clone PaddleNLP仓库地址
   cd PaddleNLP
   git checkout develop
   

2. 安装依赖：

   pip install -r requirements.txt
   

3. 编译安装：

   python setup.py install
   

Docker 方式部署

Docker 提供了完全隔离的运行环境，适合快速体验和部署：

1. 拉取 PaddlePaddle 官方镜像
2. 启动容器后安装 PaddleNLP：

   pip install --upgrade --pre paddlenlp
   

或者安装开发版：

pip install --pre --upgrade paddlenlp -f PaddlePaddle的whl仓库地址

版本选择建议

• 稳定版：适合生产环境，API 稳定
• 预发布版：包含最新功能，适合尝鲜
• 开发版：适合参与项目开发或需要最新修复

常见问题排查

1. 版本冲突：确保 PaddlePaddle 和 PaddleNLP 版本兼容
2. CUDA 不匹配：检查 CUDA 版本与安装的 PaddlePaddle 版本是否对应
3. 环境污染：建议使用虚拟环境隔离安装

结语

本文介绍了 PaddleNLP 的多种安装方式，用户可以根据自身需求选择最适合的安装方法。对于大多数应用场景，推荐使用 pip 直接安装或 Conda 环境安装。后续我们将深入介绍 PaddleNLP 的核心功能和使用方法。

PaddleNLP 👑 Easy-to-use and powerful NLP and LLM library with 🤗 Awesome model zoo, supporting wide-range of NLP tasks from research to industrial applications, including 🗂Text Classification, 🔍 Neural Search, ❓ Question Answering, ℹ️ Information Extraction, 📄 Document Intelligence, 💌 Sentiment Analysis etc. 项目地址: https://gitcode.com/gh_mirrors/pa/PaddleNLP