安装指南 ============== 本教程面向使用 LLAMA-Factory & 昇腾的开发者,帮助完成昇腾环境下 LLaMA-Factory 的安装。 LLAMA-Factory 下载安装 --------------------------- 下载 LLAMA-Factory 并进入项目目录,本文档所有操作均在该目录下进行: .. code-block:: shell :linenos: git clone https://github.com/hiyouga/LLaMA-Factory.git cd LLaMA-Factory 此处提供 docker 和 pip 两种安装方式,请按需选择: .. raw:: html
安装方式
Docker
pip
--------------- .. raw:: html

使用 pip

备注

请确保已经根据快速安装昇腾环境指引安装了对应的CANN-toolkit版本以及相应的固件和驱动,并应用了CANN-toolkit环境变量。

警告

LLAMA-Factory 支持的 CANN 最低版本为 8.0.rc1。安装 CANN 时,请同时安装 Kernel 算子包。

Python 环境创建

创建并激活 Python 环境:

conda create -y -n llamafactory python=3.10
  conda activate llamafactory

LLaMA-Factory 安装

使用以下指令安装带有 torch-npu 的 LLaMA-Factory:

pip install -e ".[torch-npu,metrics]" -i https://pypi.tuna.tsinghua.edu.cn/simple

使用 Docker

备注

请确保已经根据快速安装昇腾环境指引安装了对应的的固件和驱动。

提示

更多 CANN 的基础镜像选择见ascendai/cann

此处提供使用 docker-compose 构建及启动 docker 容器和不使用 docker-compose 两种构建方式,请根据需求选择其一。

使用 docker-compose 构建及启动 docker 容器

进入存放 Dockerfile 及 docker-compose.yaml 的 docker-npu 目录:

cd docker/docker-npu

构建 docker 镜像并启动 docker 容器:

docker-compose up -d

进入 docker 容器:

docker exec -it llamafactory bash

不使用 docker-compose

构建 docker 镜像:

docker build -f ./docker/docker-npu/Dockerfile --build-arg INSTALL_DEEPSPEED=false --build-arg PIP_INDEX=https://pypi.org/simple -t llamafactory:latest .

启动 docker 容器:

docker run -dit \
    -v ./hf_cache:/root/.cache/huggingface \
    -v ./ms_cache:/root/.cache/modelscope \
    -v ./data:/app/data \
    -v ./output:/app/output \
    -v /usr/local/dcmi:/usr/local/dcmi \
    -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
    -v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
    -v /etc/ascend_install.info:/etc/ascend_install.info \
    -p 7860:7860 \
    -p 8000:8000 \
    --device /dev/davinci0 \
    --device /dev/davinci_manager \
    --device /dev/devmm_svm \
    --device /dev/hisi_hdc \
    --shm-size 16G \
    --name llamafactory \
    llamafactory:latest

进入 docker 容器:

docker exec -it llamafactory bash
安装校验 ---------------------- 使用以下指令对 LLaMA-Factory × 昇腾的安装进行校验: .. code-block:: shell llamafactory-cli env 如下所示,正确显示 LLaMA-Factory、PyTorch NPU 和 CANN 版本号及 NPU 型号等信息即说明安装成功。 .. code-block:: shell - `llamafactory` version: 0.8.2.dev0 - Platform: Linux-4.19.90-vhulk2211.3.0.h1543.eulerosv2r10.aarch64-aarch64-with-glibc2.31 - Python version: 3.10.14 - PyTorch version: 2.1.0 (NPU) - Transformers version: 4.41.2 - Datasets version: 2.19.2 - Accelerate version: 0.31.0 - PEFT version: 0.11.1 - TRL version: 0.9.4 - NPU type: xxx - CANN version: 8.0.RC2.alpha001 LLaMA-Factory 卸载 ---------------------- .. code-block:: shell :linenos: pip uninstall llamafactory