diff --git a/.gitattributes b/.gitattributes
index 686a032..06fd2d4 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -2,3 +2,4 @@ runs/*.png filter=lfs diff=lfs merge=lfs -text
 runs/*.jpg filter=lfs diff=lfs merge=lfs -text
 runs/*.jpeg filter=lfs diff=lfs merge=lfs -text
 runs/*.gif filter=lfs diff=lfs merge=lfs -text
+artifacts/*.npz filter=lfs diff=lfs merge=lfs -text
diff --git a/.gitignore b/.gitignore
index a685653..5586be6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,12 +25,16 @@ Thumbs.db
 *.pkl
 !artifacts/codebook/*.pkl
 
+# Large codebook artifacts — upload manually via HF or GitHub UI
+artifacts/spectral_codebook_v4.npz
+
 # Reference images (hosted on HF: https://huggingface.co/datasets/aoxo/reverse-synthid)
 gemini_black/
 gemini_white/
 gemini_random/
 gemini_black_nb_pro/
 gemini_white_nb_pro/
+runs/
 
 # Secrets
 .env