Arama Yap Mesaj Gönder
Biz Sizi Arayalım
+90
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro

Bize Ulaşın

Konum Halkalı merkez mahallesi fatih cd ozgur apt no 46 , Küçükçekmece , İstanbul , 34303 , TR
EKA SUNUCU · AI MODEL EĞİTİM HATA MERKEZİ

LoRA/QLoRA Model Kaydetme, Resume, Merge and Unload ve Checkpoint Rehberi

adapter_model.safetensors, adapter_config.json, Trainer checkpoint, resume, merge_and_unload, quantized merge ve model doğrulama süreçlerini öğrenin.

PyTorchTransformersPEFT / TRLSon teknik kontrol: 14 Ağustos 2026
01

Resmî dokümantasyonla doğrulanan temel noktalar

01

PEFT adapter checkpoint'i base modelin bütün weights'ini içermez; adapter_config ve adapter weights base model kimliğine bağlıdır.

02

`merge_and_unload()` in-place değildir; dönen modeli yeniden değişkene atamak gerekir.

03

Merge sonrası PEFT özellikleri kaybolur ve bazı quantization/PEFT yöntemleri merge'i desteklemeyebilir.

02

Üç farklı şey: adapter save, Trainer checkpoint, merged model

`save_pretrained()` ile kaydedilen PEFT adapter inference için küçük adapter dosyalarıdır. Trainer checkpoint ise optimizer, scheduler, RNG ve training state içerebilir; eğitime devam etmek için kullanılır. Merged model ise base + adapter weight'lerinin tek standalone modelde birleştirilmiş halidir.

03

Adapter klasöründe ne olmalı?

Tipik LoRA adapter klasöründe `adapter_model.safetensors` ve `adapter_config.json` bulunur. Tokenizer değiştiyse tokenizer dosyalarını da aynı release altında saklayın. Yeni token/embedding eğittiyseniz PEFT troubleshooting rehberindeki embedding save kurallarını ayrıca uygulayın.

04

Resume için yalnız adapter dosyası yeterli değildir

Aynı training state'ten devam etmek istiyorsanız optimizer state, scheduler step, global step ve RNG gibi Trainer checkpoint bileşenleri gerekir. Sadece adapter'ı yükleyip trainer'ı sıfırdan başlatmak ağırlıkları devam ettirir ama optimizer/scheduler geçmişini birebir sürdürmez.

05

`resume_from_checkpoint` öncesi kontrol

Base model revision, tokenizer, PEFT config, dataset preprocessing ve package versions değiştiyse checkpoint teknik olarak yüklenebilir ama training davranışı değişebilir. Resume metadata dosyasında model ID/revision, git commit, pip freeze ve dataset fingerprint saklayın.

06

`merge_and_unload()` doğru kullanımı

PEFT resmî örneği `model = model.merge_and_unload()` biçimindedir. Dönen model artık normal base-model sınıfına yakın standalone modeldir; adapter disable/switch gibi PEFT operasyonlarını yapamazsınız. Adapter'ı geri ayırmak istiyorsanız `merge_adapter()`/`unmerge_adapter()` yaklaşımı farklıdır.

07

QLoRA merge neden daha hassas?

4-bit training sırasında base weights quantized temsil kullanır. Merge için çoğu workflow base modeli hedef output dtype'ta yeniden yükleyip adapter'ı ona merge eder. Quantized module üzerinde doğrudan merge her yöntem/config için desteklenmez; PEFT checkpoint dokümanı bu sınırlamayı özellikle belirtir.

08

Merge sonrası kalite neden değişebilir?

Yanlış base revision, farklı tokenizer, yanlış dtype, adapter scale, missing resized embeddings veya merge edilmeyen modüller çıktı farkı oluşturabilir. Merge öncesi adapter model ile merge sonrası standalone model aynı prompt setinde deterministic A/B test edilmelidir.

09

Modeli kaydettikten sonra doğrulama

Yeni Python process açın ve modeli diskten sıfırdan load edin. Aynı validation prompt setiyle adapter-load ve merged-load çıktısını karşılaştırın; parametre dtype, vocab size, EOS/PAD ID ve generation config'i yazdırın. 'Aynı process'te çalıştı' yeterli doğrulama değildir.

10

Checkpoint saklama stratejisi

Her 50 step'i sonsuza kadar saklamak yerine best metric, latest resumable checkpoint ve birkaç milestone tutun. Adapter çok küçük olsa da optimizer state büyük olabilir; depolama planını GPU training kadar ciddiye alın.

DIAGNOSTIC MATRIX

Hangi dosya ne işe yarar?

ArtefaktAmaçResume için
adapter_model.safetensorsLoRA weightsTek başına tam değil
adapter_config.jsonPEFT configGerekli context
Trainer checkpointOptimizer/scheduler/stateEvet
Merged modelStandalone inferenceHayır
Üretim ortamı notu

Çalışan eğitim ortamında paketleri rastgele güncellemeyin. GPU modeli, driver, CUDA/PyTorch runtime, transformers, accelerate, peft, trl, bitsandbytes/diffusers sürümleri ile model revision ve dataset fingerprint bilgisini her run için kaydedin. Önce minimal reproducible test oluşturun, sonra production eğitime müdahale edin.

FAQ

Sık sorulan sorular

`merge_and_unload()` adapter dosyasını siler mi?

Memory'deki PEFT yapısını merged modele dönüştürür; disk üzerindeki adapter dosyanız siz silmedikçe kalır.

Merged modelden LoRA'yı tekrar ayırabilir miyim?

`merge_and_unload()` sonrası normal PEFT unmerge işlevleri yoktur. Reversible ihtiyaçta adapter dosyasını ayrıca saklayın veya `merge_adapter()` yolunu kullanın.

OFFICIAL SOURCES

Resmî teknik kaynaklar ve proje issue'ları

CLUSTER

İlgili AI eğitim rehberleri

EKA SUNUCU · GPU ALTYAPISI

Eğitim konfigürasyonunuza göre GPU seçin.

Model boyutu, precision, context, batch, LoRA/QLoRA veya full fine-tuning yöntemi ve multi-GPU ihtiyacınızı birlikte değerlendirin; yalnız GPU model adına bakarak kapasite seçmeyin.

GPU Sunucu VPS Destek
Top