Lesson 10 / 27
LoRA and Parameter-Efficient Fine-Tuning
Train a tiny low-rank update instead of the whole weight matrix.
The needed change is often low-rank
Updating every weight is expensive and yields a full model copy per task. Parameter-efficient fine-tuning (PEFT) trains only a few added parameters. LoRA freezes each chosen weight matrix W and learns ΔW = A·B, where A is d×r and B is r×d with a small rank r (for example 8). That is r·2d trainable numbers instead of d²: for d = 4096, r = 8, about 65,000 instead of 16.8 million per matrix (0.39%). The bet is that the needed change is low-rank. The adapter is megabytes, can be swapped per task on one base model or merged for serving; QLoRA also stores the frozen base in 4-bit form.
Recovering a rank-2 change with a rank-2 adapter, run
I ran this with Python, numpy 2.5.3 and scikit-learn 1.9.1, with fixed random seeds. It trains small classical models, not a language model: the mechanics (gradient descent, learning rate, overfitting, forgetting, low-rank updates) are the same ideas that apply to fine-tuning an LLM, but the numbers are not LLM results. A frozen 32x32 matrix needs a rank-2 change. With no update the error is 3.29; a rank-1 adapter (64 trainable numbers, 6%) cuts it to 1.64; rank 2 (128 numbers, 12%) reaches essentially zero, and rank 4 also reaches zero.
import numpy as np
rng = np.random.default_rng(1)
d, true_rank = 32, 2
W0 = rng.normal(size=(d, d)) / np.sqrt(d) # frozen "pretrained" weight
delta = (rng.normal(size=(d, true_rank)) @ rng.normal(size=(true_rank, d))) * 0.3 # the change the new task needs: rank 2
W_target = W0 + delta
X = rng.normal(size=(400, d)); Y = X @ W_target.T # task data produced by the target weights
def train_lora(r, steps=3000, lr=0.02):
A = rng.normal(size=(d, r)) * 0.1; B = np.zeros((r, d)) # W = W0 + A @ B ; only A and B are trained
for _ in range(steps):
W = W0 + A @ B
err = X @ W.T - Y # (n, d)
G = err.T @ X / len(X) # gradient wrt W (d, d)
gA, gB = G @ B.T, A.T @ G
A -= lr * gA; B -= lr * gB
return float(np.mean((X @ (W0 + A @ B).T - Y) ** 2)), A.size + B.size
print("frozen W0 only: loss", round(float(np.mean((X @ W0.T - Y) ** 2)), 4), "| full matrix has", d * d, "parameters")
for r in (1, 2, 4):
loss, params = train_lora(r)
print(f"LoRA rank {r}: loss {loss:.5f} with {params} trainable parameters ({params / (d * d):.0%} of the full matrix)")
Output:
frozen W0 only: loss 3.2905 | full matrix has 1024 parameters LoRA rank 1: loss 1.63657 with 64 trainable parameters (6% of the full matrix) LoRA rank 2: loss 0.00000 with 128 trainable parameters (12% of the full matrix) LoRA rank 4: loss 0.00000 with 256 trainable parameters (25% of the full matrix)
Training memory: full fine-tune versus LoRA, run
I ran this with plain Python 3 (standard library only), using example numbers. With the rough estimate of 16 bytes per trained parameter, a 7B model needs about 112 GB to fully fine-tune but about 14 GB when only a 0.4% adapter trains over a frozen 2-byte base. Rough planning numbers before activations and overhead.
# Rough training memory (mixed precision with Adam): weights 2 B + gradients 2 B + fp32 master weights 4 B + 2 optimizer states 8 B
# = about 16 bytes per TRAINED parameter, plus frozen weights at 2 B per parameter. Activations come on top.
def gb(x): return x / 1e9
def full_ft(params): return params * 16
def lora(params, trainable): return params * 2 + trainable * 16 # frozen base at 16-bit + trained adapters
for name, params in (("7B", 7e9), ("13B", 13e9), ("70B", 70e9)):
trainable = params * 0.004 # ~0.4% trainable with a small-rank adapter (example)
print(f"{name:4} full fine-tune ~ {gb(full_ft(params)):7.0f} GB LoRA ~ {gb(lora(params, trainable)):6.0f} GB (before activations)")
Output:
7B full fine-tune ~ 112 GB LoRA ~ 14 GB (before activations) 13B full fine-tune ~ 208 GB LoRA ~ 27 GB (before activations) 70B full fine-tune ~ 1120 GB LoRA ~ 144 GB (before activations)
Quick check: What does LoRA train?
- Small low-rank matrices added to frozen weights
- Every weight of the model
- Only the tokenizer
- The user interface
Answer
Small low-rank matrices added to frozen weights — The adapter learns a compact update while the base stays frozen.