---
title: 环境配置
description: "在源码编译构建前需要安装对应版本的依赖组件。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengai/ecosystemEnable/transformers/kunpengtransformers_16_0004.html
sourcePath: /source/zh/kunpengai/ecosystemEnable/transformers/kunpengtransformers_16_0004.html
indexId: 9d1310236efc6bd6b4264bcd670a1a96d28734e922361fb870b8724e833cb02282
---
# 环境配置

在源码编译构建前需要安装对应版本的依赖组件。

1. 安装系统依赖。
  1 2 3 4 dnf install -y \ --setopt=install_weak_deps=False \ --setopt=tsflags=nodocs \ python3-pip tar gzip

2. 安装Python构建工具。
  1 python3 -m pip install --upgrade pip setuptools wheel packaging hatchling

3. 安装CUDA版本的PyTorch。

  - 方式一：使用官方预编译wheel。
    1 python3 -m pip install --index-url https://download.pytorch.org/whl/cu130 torch==2.11.0+cu130

  - 方式二：使用本地构建wheel，替换为实际wheel文件路径。
    1 python3 -m pip install --force-reinstall /path/to/torch-2.11.0+cu130-*.whl

安装CUDA版本PyTorch以上两种方式二选一：可以使用PyTorch官方发布的、与CUDA版本匹配的预编译wheel，也可以使用已在当前环境验证通过的本地构建CUDA wheel。无论选择哪种来源，继续源码构建Transformers前都必须确认torch.backends.cuda.is_built()和torch.cuda.is_available()均为True。