LibreAI / Dev Tools / LlamaFactory
// devtools · hiyouga/LlamaFactory

LlamaFactory

Unified, efficient fine-tuning of 100+ LLMs and VLMs with a CLI and Web UI — ACL 2024

★ 75.4k stars⑂ 9.2k forksApache-2.0updated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

LlamaFactory is an open-source dev tools project by hiyouga (hiyouga/LlamaFactory on GitHub). It has 75,362 GitHub stars and 9,239 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 28 September 2026.

GitHub stars
75,362
Forks
9,239
License
Apache-2.0
Last updated on GitHub
28 September 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want from LlamaFactory and check the README and requirements to confirm it fits your setup and Python environment.

  2. Get the code

    Clone the repository from GitHub (github.com/hiyouga/LlamaFactory) or use the documented install channel if you do not need the source.

  3. Install and configure

    Follow the README quickstart to install dependencies and set any required configuration or credentials.

  4. Run your first task

    Work through the README's first example end to end, then adapt it to your own project or data.

// features

Why people love it

100+ models

Fine-tune over 100 LLMs and vision-language models including Llama, Qwen, Gemma and DeepSeek families.

Many training methods

Supports pre-training, SFT, RLHF, LoRA, QLoRA and quantization workflows.

Zero-code Web UI

Llama Board GUI (Gradio) lets you configure and launch training without writing code.

Day-N model support

Actively adds new cutting-edge models as they are released.

Provided datasets

Ships curated datasets for instruction tuning and preference training.

Docker images

Official Docker images, including Ascend NPU variants, for reproducible training.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Start by getting the source and entering the project directory.

    git clone https://github.com/hiyouga/LlamaFactory.git
    cd LlamaFactory
  2. Install from source

    Clone shallow and install in editable mode, per the README quickstart.

    git clone --depth 1 https://github.com/hiyouga/LlamaFactory.git
    cd LlamaFactory
    pip install -e .
  3. Launch the Web UI

    Start Llama Board to configure your first fine-tune in the browser.

    llamafactory-cli webui  # or: uv run llamafactory-cli webui
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains LlamaFactory?

It is maintained by hiyouga and contributors on GitHub, where the repository github.com/hiyouga/LlamaFactory is the canonical home for code, issues and releases.

Is LlamaFactory free to use?

Yes — it is open source under the Apache-2.0 license. Read the license in the repository for what is permitted, including any conditions on redistribution or commercial use.

Does it need a paid API key?

No API key needed — training is local on your hardware; you need a suitable GPU for most models.

How does LlamaFactory compare to alternatives?

Compared with Hugging Face TRL alone: LlamaFactory unifies many models, methods and datasets behind one CLI and Web UI instead of wiring libraries together yourself.

How do I get started?

Clone github.com/hiyouga/LlamaFactory, follow the README quickstart to install it, and run the documented first example before adapting it to your own work.

// keep exploring

Similar tools

Dev Tools

peft

Fine-tune huge models on small hardware with LoRA and other efficient methods

★ 21.8k starsApache-2.0
View guide →
Dev Tools

evalscope

A streamlined framework for evaluating and benchmarking LLMs, VLMs and AIGC models.

★ 3.5k starsApache-2.0
View guide →
Dev Tools

Chat2DB

A local-first database client with AI SQL help — 40+ databases, desktop, web, Docker and CLI

★ 28.3k starsApache-2.0
View guide →
Dev Tools

ms-swift

Fine-tune and deploy 600+ LLMs and 300+ multimodal models with PEFT or full-parameter training.

★ 15.8k starsApache-2.0
View guide →
Dev Tools

trafilatura

Trafilatura — a Python and CLI tool to crawl the web and extract clean text and metadata for corpora and RAG.

★ 6.9k starsApache-2.0
View guide →
Dev Tools

ddgs

A Python metasearch library aggregating many web search services — plus CLI, API and MCP server

★ 3.0k starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if LlamaFactory is not the right fit.

Get LlamaFactory

Free and open — grab the source, star the repo, and start creating.