1. Windows
LLaMA-Factory 的 Github 地址:https://github.com/hiyouga/LLaMA-Factory
克隆仓库(示例目录为 D:\Program Files\LLaMa-Factory,Linux 可直接在根目录克隆)
git clone --depth 1 https://github.com/hiyouga/LLaMA-Factory.git
切换到项目目录
cd LLaMA-Factory
修改配置,将 conda 虚拟环境安装到数据盘(若已配置则跳过此步)
mkdir -p "D:\Program Files\conda\pkgs"
conda config --add pkgs_dirs "D:\Program Files\conda\pkgs"
mkdir -p "D:\Program Files\conda\envs"
conda config --add envs_dirs "D:\Program Files\conda\envs"
或直接修改 C 盘配置文件(C:\Users\Administrator.condarc)
打开 Anaconda Prompt(管理员模式),若已将 conda 加入环境变量则直接在当前目录操作。
创建 conda 虚拟环境(必须使用 Python 3.10 版本,否则与 LLaMA-Factory 不兼容)
conda create -n llama-factory python=3.10
接受所有条款后重新执行上述操作
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/msys2
激活环境
conda activate llama-factory
下载依赖
pip install -e ".[torch,metrics]"
若报错,先激活环境并初始化(当前目录或 Anaconda Prompt)
conda init
重新下载依赖即可。
若仍报错,可尝试更改 Python 版本:
conda create -n llama-factory-py311 python=3.11
source ~/.bashrc
检验是否安装成功
llamafactory-cli version
启动 LLaMA-Factory 的可视化微调界面(由 Gradio 驱动)
llamafactory-cli webui


