一文全面了解Llama-Factory：大模型微调工具从入门到实践指南_AI热点日报

一文全面了解Llama-Factory：大模型微调工具从入门到实践指南

类型：热点整理2026-07-09

Llama-Factory是基于Transformer的大模型训练部署工具，集多模型支持、高效微调（LoRA等）、多模态训练、数据预处理、可视化监控与一键部署于一体。以Llama3与弱智吧数据集为例，演示了LoRA微调实战流程，助力开发者快速完成模型定制。

探索 AI 大模型工具新选择，Llama-Factory 助力高效训练与部署。本教程将带您全面了解这套集成了多模型支持、高效微调、多模态训练、数据预处理、可视化监控和一键部署等功能的强大工具集，并手把手教您完成一次完整的微调实战。

一、核心功能概览

Llama-Factory 基于 Transformer 架构，为全球开发者提供了一套简单、快速且高效的大模型定制化训练与部署工具。其模块化、可扩展和流程化的框架，一站式集成了数据预处理、训练、微调、评估和推理等多种功能。以下是其六大核心功能：

1、多模型支持：兼容主流大模型架构，如 LLaMA、ChatGLM、Qwen、Falcon 等，并支持 Hugging Face 格式模型权重的加载与转换。
2、高效微调方法：提供多种参数高效微调（PEFT）技术，如 LoRA、Adapter、Prefix-Tuning 等，同时支持全量微调和分布式训练（多 GPU/TPU）。
3、多模态训练支持：可处理文本、图像、音频等多模态数据的联合训练任务。
4、数据预处理与增强：内置常用数据集的清洗、分词、格式转换工具，并提供数据增强策略（如回译、同义替换）以提升模型泛化能力。
5、可视化与监控：集成 TensorBoard 和 WandB，可实时监控训练过程中的损失、准确率等指标，并支持模型性能分析和错误案例可视化。
6、一键部署与推理：提供模型导出为 ONNX、TorchScript 等格式的工具，并支持本地或云端服务化部署（如 Docker、Kubernetes）。

小提示：如果您是新手，建议先从 LoRA 这种参数高效的微调方法入手，它能在节省显存的同时，快速完成模型适配。

二、主要组件与工具详解

LLaMA-Factory 的整体架构围绕以下几个核心模块展开，理解它们能帮助您更好地使用这套工具。

1、模型支持框架（Model Support）

支持 Hugging Face Transformers 中的主流大语言模型，包括但不限于：

LLaMA / LLaMA2 / LLaMA3
ChatGLM 系列
Baichuan 系列
Qwen 系列
InternLM
Mistral / Mixtral
Falcon / BLOOM 等

这些模型可以通过 Hugging Face 的 AutoModelForCausalLM 和 AutoTokenizer 加载，兼容性极强。

2、微调方法（Fine-tuning Methods）

通过集成 PEFT 库，支持主流的参数高效微调策略：

LoRA (Low-Rank Adaptation)
QLoRA
Prefix Tuning
Prompt Tuning
Full Fine-tuning (全量微调)
AdaLoRA、LLaMA-Adapter、IA3 等（部分支持）

用户可以根据资源和需求选择不同的微调方法。

3、训练器模块（Trainer）

基于 Hugging Face 的 Trainer 类封装，增加对 PEFT 的支持。主要特性包括：

多卡训练（DeepSpeed、FSDP）
混合精度（fp16/bf16）
Gradient Accumulation
Checkpoint 保存与恢复

4、数据处理模块（Data Preprocessing）

支持多种数据格式，自动构建训练样本，覆盖单轮和多轮对话：

SFT 格式（instruction + input + output）
Chat 格式（messages 列表）
ShareGPT、Alpaca、OpenAI 格式
自定义格式（通过转换脚本）

5、推理模块（Inference / Serving）

提供简单的推理脚本 infer.py，支持多种交互方式：

单轮 / 多轮对话
Web UI（基于 Gradio）
CLI 推理
支持加载微调后的模型进行评估或部署。

6、评估模块（Evaluation）

支持自动评估方法，让模型效果可视化：

BLEU / ROUGE / METEOR
GPT / LLM-based 评价（如 GPT-4 Judge）
MMLU、CMMLU、CEval 等标准数据集
支持模型输出与参考答案的自动对比。

7、部署模块（Serving）

提供多种可选的部署方式：

Gradio Web UI
FastAPI
OpenAI API 兼容接口（适用于本地部署大模型）

8、配置与脚本（Scripts & Configs）

提供丰富的训练、推理、部署脚本，方便快速启动任务：

train.py
infer.py
web_demo.py
export_model.py（导出为 Hugging Face 或 GGUF 格式）
提供 YAML/json 配置文件，方便快速启动训练/推理任务。

常见问题：

问：我可以自定义数据集格式吗？ 可以。LLaMA-Factory 支持多种标准格式，也允许通过编写转换脚本实现自定义格式的加载。

问：如果我的显卡显存不够（比如只有 8G），还能微调 8B 模型吗？ 可以。使用 QLoRA 或 LoRA 方法，结合 4bit 量化，可以显著降低显存占用。您还可以配合 gradient_accumulation_steps 参数，用小批量多次累计来等效大batch size。

三、微调实战：以 Llama3 与“弱智吧”数据集为例

接下来，我们将以微调 Llama3 大模型为例，使用“弱智吧 ruozhiba”数据集。相比某些微调工具，LLaMA-Factory 的操作过程非常简洁明了。

1、环境准备

首先，克隆 LLaMA-Factory 仓库并安装依赖：

git clone https://github.com/hiyouga/LLaMA-Factory.git
cd LLaMA-Factory
pip install -r requirements.txt

确保您的环境满足以下要求：

Python 3.10+
CUDA 11.8+/12.x（支持 GPU 训练）
至少一张 24G 显存的 GPU（用于 8B 模型）或多张 A100/H100（用于 70B 模型）

小提示：在安装依赖时，如果遇到网络问题，可以尝试使用国内的镜像源，如清华或阿里云的 PyPI 镜像。

2、模型与数据集下载

您可以从 Hugging Face 或魔搭社区下载 Llama3 模型和 ruozhiba 数据集。具体方法多样，这里不再详述。下图展示了下载完成的模型文件与数据集文件。

数据集来源：COIG-COIA/ruozhiba

常见问题：

问：下载模型和数据集时非常慢或总是失败，怎么办？ 您可以尝试使用国内镜像站点，如 hf-mirror.com 或魔搭社区的 modelscope.cn。在 Hugging Face 下载前，可以执行 export HF_ENDPOINT=https://hf-mirror.com 来切换镜像。

3、微调配置文件

创建一个名为 finetune_ruozhiba.sh 的 Shell 脚本，内容如下：

#!/bin/bash

CUDA_VISIBLE_DEVICES=0 accelerate launch src/train_bash.py \
  --stage sft \
  --model_name_or_path llama_models/llama-3-8b \
  --do_train \
  --dataset ruozhiba \
  --dataset_dir data \
  --template llama3 \
  --finetuning_type lora \
  --output_dir output/llama3-ruozhiba-lora \
  --overwrite_cache \
  --per_device_train_batch_size 2 \
  --gradient_accumulation_steps 4 \
  --lr_scheduler_type cosine \
  --logging_steps 10 \
  --sa ve_steps 500 \
  --learning_rate 5e-5 \
  --num_train_epochs 3 \
  --plot_loss \
  --fp16

关键参数说明：

stage sft：表示进行 SFT 微调。
model_name_or_path：预训练模型的路径。
dataset ruozhiba：数据集名称（脚本会自动在 --dataset_dir 下寻找 ruozhiba.json 文件）。
template llama3：使用 Llama3 的 prompt 模板。
finetuning_type lora：使用 LoRA 微调方式，可以大幅节省显存。
output_dir：训练完成后模型权重的输出路径。
fp16：使用半精度训练，进一步节省显存。

4、开始训练

在终端中运行以下命令：

bash scripts/llama3/finetune_ruozhiba.sh

训练完成后，输出目录结构如下：

output/llama3-ruozhiba-lora/
├── adapter_config.json
├── adapter_model.bin
├── tokenizer.model
└── ...

小提示：如果您在训练过程中显存不足，可以尝试减小 per_device_train_batch_size 的值，同时增大 gradient_accumulation_steps 来维持整体的batch大小。

5、推理测试

训练完成后，我们可以使用 src/api_demo.py 启动一个测试接口，加载微调后的 LoRA 权重进行推理：

python src/api_demo.py \
  --model_name_or_path llama_models/llama-3-8b \
  --template llama3 \
  --finetuning_type lora \
  --adapter_name_or_path output/llama3-ruozhiba-lora

常见问题：

问：这个 api_demo.py 启动后，我应该如何测试对话？ 启动后，脚本会在本地运行一个基于 FastAPI 或 Gradio 的服务。您可以在浏览器中访问它提供的 URL（通常是 http://localhost:7860 或类似的地址），直接在 Web 界面上输入问题并查看模型回答。

问：我想将微调后的模型导出保存，应该怎么做？ 您可以使用 export_model.py 脚本，它可以合并 LoRA 权重并导出为 Hugging Face 的标准格式，方便后续分享或部署。

四、总结与下一步

通过本篇教程，您已经掌握了 Llama-Factory 的核心功能、组件结构，并亲手完成了一次 LoRA 微调实战。这套工具强大的模块化设计，让您能够轻松应对从数据准备到模型部署的全流程。接下来，您可以尝试探索更多高级功能，如混合训练、多模态任务、以及使用不同的微调技术（如 QLoRA 或 Full Fine-tuning）来适应不同场景和资源条件。

来源：https://www.53ai.com/news/finetuning/2025050676401.html

ai 人工智能

延伸阅读

补充最近整理过的热点入口。