一、项目介绍

微调大模型,第二个坑是“每个模型一套流程”:LLaMA 一种脚本、Qwen 另一种、ChatGLM 又一种,换模型就要重学一遍。你要的是“一套框架,统一微调上百种 LLM/VLM”,最好还有可视化界面,点点就能训。
LLaMA-Factory 是一个统一高效的大模型微调框架(ACL 2024),覆盖 100+ LLM 与 VLM,支持 LoRA、QL-LoRA、全参等训练方式,提供 Web UI 与 CLI。它把数据、模型、训练策略收敛成统一入口,研究者与工程师换模型不再重学工具链,直接复用同一套配置。

二、项目基本信息

信息项详情
项目名称llamafactory
GitHub地址https://github.com/hiyouga/llamafactory
项目描述Unified Efficient Fine-Tuning of 100+ LLMs & VLMs (ACL 2024)
作者hiyouga
开源协议Apache-2.0
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-29

三、核心优势

  • 统一入口:100+ LLM/VLM 一套框架微调
  • 方式全:LoRA / QLoRA / 全参训练都支持
  • 有界面:Web UI 点点即可启动训练
  • 效率高:显存与速度优化,门槛更低
  • 学术背书:ACL 2024 收录,社区活跃

四、适用场景

适合做大模型微调、领域适配、VLM 训练的团队与研究者:希望用统一框架覆盖多种模型,减少切换成本。

五、安装教程

当前最新版本 latest。按下方命令安装(如遇网络问题可切换镜像源或代理):

# 克隆并安装
git clone --depth 1 https://github.com/hiyouga/LlamaFactory.git
cd LlamaFactory
pip install -e .
pip install -r requirements/metrics.txt

常见报错:依赖缺失时先升级运行环境(Node、Python、Go 等)到项目要求版本;网络超时多为镜像或代理问题,可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例:

# 启动可视化训练界面
uv run llamafactory-cli webui
# 或命令行训练(示例配置)
llamafactory-cli train examples/train_lora/llama3_lora_sft.yaml

七、常见问题

问:必须多卡吗?答:单卡也能跑 LoRA/QLoRA,多卡用于更大规模。问:支持视觉模型吗?答:支持,VLM 在覆盖范围内。

八、总结

llamafactory 用一个清晰的设计,把把一类应用范式标准化这件反复劳动变成了可复用、可维护的能力。它不追求大而全,而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰,不妨按上面的安装与使用步骤试一试,把它接进自己的工作流。