LlamaFactory: framework fine-tuning cho 100+ LLM
LlamaFactory biến fine-tuning LLM thành một workflow cấu hình rồi chạy, gói LoRA, QLoRA, PPO, DPO và nhiều phương pháp khác vào một CLI và một Web UI trên Gradio, thay vì bạn tự viết training script. Điểm mạnh nhất: nó thắng việc tự ráp riêng PEFT, TRL và code chuẩn bị dataset. Cái giá phải trả: customization sâu hơn các recipe có sẵn nghĩa là phải vật lộn với lớp abstraction, chứ không mở rộng được dễ dàng.
LlamaFactory là gì
LlamaFactory là một framework Python mã nguồn mở dùng để fine-tune các model ngôn ngữ lớn và model vision-language mà không cần tự viết training script. Nó gói LoRA, QLoRA, fine-tune toàn phần và các phương pháp preference như DPO, KTO, ORPO vào một CLI và một Web UI chạy trên Gradio có tên LlamaBoard. README liệt kê hỗ trợ hơn 100 dòng model, gồm LLaMA, Qwen3, DeepSeek, Gemma, GLM và các model đa phương thức như LLaVA.
Tính năng chính và các model được hỗ trợ
- ✓Fine-tune hơn 100 dòng model từ đầu đến cuối — LLaMA, Qwen3, DeepSeek, Gemma 3, GLM-4.5, Mixtral-MoE và các model đa phương thức như LLaVA, Qwen3-VL, MiniCPM-o
- ✓Bao trọn cả pipeline training: continuous pre-training, supervised fine-tuning, reward modeling, PPO, DPO, KTO và ORPO
- ✓LoRA và QLoRA xuống tận 2-bit, với các backend quantization AQLM, AWQ, GPTQ, LLM.int8, HQQ và EETQ
- ✓Tích hợp sẵn GaLore, BAdam, APOLLO, Adam-mini, Muon, DoRA, LongLoRA, LoRA+, LoftQ và PiSSA — chỉ cần bật bằng flag
- ✓Tăng tốc training với FlashAttention-2, Unsloth, Liger Kernel và KTransformers
- ✓Web UI LlamaBoard chạy cùng job như CLI mà không cần viết code
- ✓Serve model đã fine-tune qua API kiểu OpenAI, chạy bằng vLLM hoặc SGLang worker
- ✓Ghi log experiment vào TensorBoard, Wandb, MLflow hoặc SwanLab
Cài đặt LlamaFactory
README có nhắc tới một mục Installation riêng (cùng các trang docs riêng cho Ascend NPU và AMD GPU) nhưng nội dung đó không nằm trong tư liệu có ở đây, nên câu lệnh pip/git chính xác không được ghi rõ trong phần này. Điều được ghi rõ: bạn có thể bắt đầu không cần setup gì qua notebook Colab miễn phí, notebook PAI-DSW dùng thử miễn phí, và credit AMD GPU Cloud miễn phí — đều được link từ README — cộng với trang Documentation (đang ghi là work-in-progress) tại llamafactory.readthedocs.io cho phần setup local/cloud đầy đủ.
Fine-tuning bằng CLI và Web UI
Training local bắt đầu từ CLI, được ghi trong mục Getting Started/Quickstart của README; đường không-code là `train_web.py`, được project mô tả là một Web UI all-in-one cho training, evaluation và inference — đây chính là thứ chạy LlamaBoard. Không cần tự viết loop. Người dùng cloud có thể bỏ qua setup local hoàn toàn: README link tới notebook Colab miễn phí, notebook PAI-DSW dùng thử miễn phí, và credit AMD GPU Cloud để fine-tune mà không cần dựng hardware. Serve một checkpoint sau đó đi qua API kiểu OpenAI có sẵn, chọn vLLM hoặc SGLang qua argument `infer_backend` để inference nhanh và concurrent hơn; project cũng export thẳng checkpoint sang Ollama modelfile được.
Điểm mạnh
- ✓Một framework bao trọn pre-training, SFT, reward modeling và preference tuning DPO/KTO/ORPO thay vì phải ráp riêng lẻ nhiều library
- ✓LlamaBoard cho teammate không rành infra một Web UI chạy được ngay, không cần đụng vào file config
- ✓Các chiêu quantization và tăng tốc (QLoRA, FlashAttention-2, Unsloth, Liger Kernel) đã được nối sẵn thành flag, không phải tích hợp bạn tự làm
- ✓Đường vào cloud miễn phí (Colab, PAI-DSW, AMD GPU Cloud) giúp test thử không tốn gì trước khi đầu tư hardware
- ✓README dẫn các case dùng thực tế từ Amazon, NVIDIA và Aliyun, nên đường tích hợp với các cloud lớn ít nhất cũng có tài liệu ở đâu đó
Yêu cầu phần cứng và giới hạn
- △Documentation tự ghi là work-in-progress trên trang docs riêng, nên một số workflow dễ tìm trong changelog hơn là trong guide
- △README tự cảnh báo rằng ngoài các link được liệt kê, các website khác đều là bên thứ ba không được ủy quyền — nên biết trước khi tìm install guide hay mirror
- △Fine-tune toàn phần các dòng model lớn vẫn cần nhiều GPU memory; ví dụ chính README đưa ra để fit một model 70B vào 2x24GB GPU cần kết hợp FSDP+QLoRA, không phải chạy thường
- △Bao phủ nhiều phương pháp (hơn chục thuật toán tuning, nhiều backend quantization) nghĩa là nhiều bề mặt cấu hình hơn so với một tool chỉ làm một phương pháp
Các lựa chọn thay thế cho LlamaFactory
Câu hỏi thường gặp
README của LlamaFactory liệt kê hỗ trợ hơn 100 dòng model, gồm LLaMA, Qwen3, DeepSeek, Gemma 3, GLM-4.5, Mixtral-MoE và Phi, cộng với các model đa phương thức như LLaVA, Qwen3-VL và MiniCPM-o cho tác vụ ảnh, video và audio.
LlamaFactory miễn phí và mã nguồn mở, phát hành theo license Apache-2.0 trên GitHub — dùng, sửa và tự host thoải mái cho cả dự án cá nhân lẫn thương mại.
Yêu cầu phần cứng thay đổi theo phương pháp fine-tune: fine-tune toàn phần model lớn cần nhiều GPU memory cao, còn LoRA và QLoRA giảm mạnh yêu cầu đó — chính README dùng FSDP+QLoRA để fit một model 70B vào chỉ 2x24GB GPU. LlamaFactory cũng hỗ trợ Ascend NPU và AMD GPU với docs setup riêng.
Cả hai đều là framework fine-tuning LLM mã nguồn mở, nhưng cách cấu hình khác nhau: Axolotl xoay quanh một file YAML cho mỗi lần chạy, còn LlamaFactory ghép CLI với Web UI LlamaBoard cho ai muốn có lựa chọn giao diện, không chỉ config file. Chọn cái nào thường tùy bạn thích sửa YAML hay click qua UI hơn.
LlamaFactory tích hợp vLLM như một trong các backend inference của nó — đặt `infer_backend: vllm` trong config sẽ route việc serve qua vLLM để inference nhanh và concurrent hơn cho checkpoint đã fine-tune. SGLang cũng được hỗ trợ tương tự như một backend thay thế.
LlamaFactory hỗ trợ trực tiếp LLaVA và các model đa phương thức khác, bao gồm các tác vụ hiểu ảnh, visual grounding, nhận diện video và hiểu audio bên cạnh fine-tune văn bản thuần, với các model như Qwen2.5-VL, Qwen3-VL và MiniCPM-o cũng nằm trong danh sách hỗ trợ.
Vấn đề mà nó giải quyết
Fine-tune một LLM thường có nghĩa là chọn một phương pháp (LoRA? QLoRA? full-parameter?), rồi tự viết code nối giữa model loader, PEFT wrapper, trainer và serving stack — rồi lặp lại việc đó cho mỗi kiến trúc mới mà Meta, Qwen hay DeepSeek ra mắt. LlamaFactory thay thế phần code nối đó bằng một mặt cấu hình duy nhất: cùng một CLI/Web UI xử lý pre-training, SFT, reward modeling và preference tuning trên một danh mục model rộng, nên một bản release mới như Qwen3 hay Gemma 3 chỉ còn là đổi template thay vì viết lại từ đầu.
Trường hợp sử dụng tốt nhất
- •Fine-tune toàn phần hoặc LoRA/QLoRA một chat model mã nguồn mở trên một GPU consumer duy nhất
- •SFT đa phương thức cho các tác vụ hiểu ảnh hoặc visual grounding với model như LLaVA hay Qwen2.5-VL
- •Preference tuning (DPO/KTO/ORPO) một base model thành bản chat hoặc bản đã align an toàn
- •Dựng endpoint inference tương thích OpenAI cho model đã fine-tune qua vLLM hoặc SGLang
- •Thử nghiệm không cần viết code qua LlamaBoard, hợp cho team chưa có kỹ sư training-infra riêng
Ai nên dùng — và ai nên bỏ qua
Nên dùng LlamaFactory nếu bạn đã biết mình cần model nào và phương pháp nào (LoRA, QLoRA, DPO...) và chỉ cần nối chúng lại thật nhanh — một data scientist test thử một bản fine-tune trước khi viết code production, hay một team nhỏ chưa có người chuyên infra ML, cả hai đều tận dụng tốt LlamaBoard và các recipe dựng sẵn. Bỏ qua nếu bạn cần một training loop tự viết lại từng dòng, hoặc phương pháp fine-tuning bạn cần không nằm trong danh sách đã hỗ trợ — lúc đó bạn sẽ tốn thời gian lách qua framework nhiều hơn là tự viết loop.
Repo liên quan
LlamaFactory có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về LlamaFactory.
