// devtools · huggingface/peft

peft

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

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

Project facts

peft is an open-source dev tools project by huggingface (huggingface/peft on GitHub). It has 21,769 GitHub stars and 2,560 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
21,769
Forks
2,560
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Choose a base model and method

    Pick the model to adapt and a method such as LoRA that fits your memory budget.

  2. Get PEFT

    Install the peft package from PyPI - cloning is only needed to work on the library itself.

  3. Configure the adapter

    Wrap your model with a PEFT config (for example LoraConfig) using the README quickstart.

  4. Train your first adapter

    Train on your dataset, check the trainable-parameter count, and save the small adapter.

// features

Why people love it

LoRA and more

Implements LoRA and a family of parameter-efficient methods behind one consistent API.

Huge memory savings

The README's example trains about 0.12% of a 3B model's parameters with LoRA instead of the full model.

Transformers integration

Use PEFT models directly through the Transformers integration for training and inference.

Diffusers support

Apply parameter-efficient tuning to diffusion models as well as language models.

Accelerate and TRL ready

Works with Accelerate for distributed/offloaded training and with TRL for RLHF-style workflows.

Quantization friendly

Combines with quantization so large models can be adapted on modest GPUs.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source code from GitHub and enter the project directory.

    git clone https://github.com/huggingface/peft.git
    cd peft
  2. Install PEFT

    Install from PyPI alongside Transformers and Accelerate.

    pip install peft
  3. Wrap a model with LoRA

    The README quickstart loads a model, applies a LoraConfig, and prints the trainable parameter share.

    from peft import LoraConfig, get_peft_model
    # load a model, then:
    # model = get_peft_model(model, LoraConfig(...)) - see README quickstart
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains this project?

It is maintained by Hugging Face and contributors on GitHub.

Is it free to use?

Yes - PEFT is Apache-2.0 licensed and free to use. Base models you adapt carry their own licenses.

Does it need a paid API key?

No API key is needed: training and inference run locally on your hardware with open models.

How does it compare to alternatives?

Compared with full fine-tuning, PEFT trains a fraction of the parameters (often well under 1%), cutting compute and storage; compared with prompt-only methods, it actually updates model behavior.

How do I get started?

Run pip install peft and follow the README Quickstart to wrap a model with LoRA and print its trainable parameters.

// keep exploring

Similar tools

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

LlamaFactory

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

★ 75.4k starsApache-2.0
View guide →
Dev Tools

little-coder

A coding-agent harness optimized for smaller local LLMs — small models, serious coding work

★ 2.7k starsApache-2.0
View guide →
Dev Tools

inspector

MCPJam Inspector: chat with, inspect, debug, and evaluate MCP servers across clients and models.

★ 2.2k starsApache-2.0
View guide →
Dev Tools

llm-course

A free course to get into large language models, with roadmaps and runnable Colab notebooks

★ 83.3k starsApache-2.0
View guide →
Dev Tools

datasets

Hugging Face's library for loading and processing datasets for AI models in one line

★ 22.0k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

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

Get peft

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