Hugging Face’te Model Nasıl Paylaşılır? Repo, Model Kartı ve Lisans Rehberi (2026)

Hugging Face’te bir modeli yayınlamak, dosya yüklemekten çok daha fazlasını içerir: bir model deposu (repo) oluşturmak, ağırlıkları ve konfigürasyonları yüklemek, model kartı yazmak, lisans türünü tanımlamak ve gerekiyorsa erişimi onaya bağlamak gerekir. Bu rehberde model paylaşımının teknik adımlarını, model kartı ve lisanslama mantığını baştan sona anlatıyoruz (Hugging Face’in genel işleyişine bu rehberden göz atabilirsiniz).

Model Deposu (Repo) Nasıl Oluşur?

Hugging Face’te her kullanıcı veya kurum kendi model deposunu açabilir. Bu depo Git tabanlıdır; yani sürüm kontrolü, dallanma (branch) ve commit geçmişi gibi özellikler taşır. Depo public (herkese açık) veya private (sadece belirli kişilere açık) olarak oluşturulabilir. Depo oluşturulduktan sonra ağırlık dosyaları, konfigürasyon dosyaları, eğitim veya çıkarım kodu örnekleri ve model kartı eklenir.

Model yüklenirken lisans tipi ve modelin “gated” (onaylı erişim) olup olmadığı da belirtilir. Bu iki ayar, başkalarının modelinizi nasıl bulabileceğini ve kullanabileceğini doğrudan etkiler.

Bir Model Deposunda Hangi Dosyalar Bulunur?

Tipik bir model deposu şu dosya türlerini içerir:

.
├── .gitattributes
├── config.json
├── generation_config.json
├── README.md          (model kartı)
├── tokenizer.json
├── tokenizer_config.json
├── model.safetensors.index.json
└── weights/
    ├── model-00001-of-00003.safetensors
    ├── model-00002-of-00003.safetensors
    └── model-00003-of-00003.safetensors

Adım Adım Model Yükleme

huggingface-cli login
huggingface-cli repo create kullanici-adi/model-adi --type model
huggingface-cli upload kullanici-adi/model-adi ./model-dizini/ .

from huggingface_hub import HfApi
api = HfApi()
api.upload_folder(
    folder_path="./model-dizini",
    repo_id="kullanici-adi/model-adi",
    repo_type="model",
)

İyi Bir Model Kartı Nasıl Yazılır?

Model kartı, modelinizin kullanım kılavuzu niteliğindedir ve topluluğun modeli doğru, güvenli ve yasal şekilde kullanabilmesi için kritik önem taşır. Ne kadar şeffaf ve ayrıntılı olursa, modelin benimsenme olasılığı da o kadar artar. Tipik bir model kartı şu bölümleri içerir:

• Amaç ve kullanım alanları: Modelin hangi görevler için tasarlandığı ve hangi senaryolarda (tıbbi teşhis, yasal karar gibi) kullanılmaması gerektiği.
• Eğitim verisi ve yöntem: Hangi veri setlerinin kullanıldığı, ön işleme adımları, eğitim süresi ve donanım.
• Performans ve değerlendirme: Hangi metriklerin hangi veri setlerinde elde edildiği, bilinen zayıf yönler.
• Lisans ve kullanım koşulları: Lisans türü, ticari kullanıma açık olup olmadığı, türev model yükümlülükleri.
• Güvenlik ve riskler: Zararlı içerik üretme riski, önyargı (bias) sorunları, kötüye kullanım senaryoları.
• Kullanım örneği: Modelin transformers veya benzeri bir kütüphaneyle nasıl yükleneceğine dair kısa bir kod parçası.

Lisans Türleri ve Ticari Kullanım

Hugging Face’te üç ana lisanslama yaklaşımı öne çıkıyor:

• Açık lisanslar: Apache 2.0, MIT ve bazı Creative Commons türevleri. Genellikle ticari kullanıma ve türev model oluşturmaya izin verir.
• Topluluk (community) lisansları: Llama Community License, Qwen License gibi lisanslar. Genellikle açık ağırlıklıdır ama belirli bir gelir eşiğinin üzerinde ücret veya rakip modellerde kullanım yasağı gibi kısıtlamalar içerebilir.
• Kapalı veya sadece araştırma amaçlı lisanslar: Bazı modeller yalnızca akademik kullanım için serbesttir; ticari kullanım için ayrı bir anlaşma gerekir.

Önemli bir uyarı: API’de görünen lisans etiketi her zaman tüm koşulları yansıtmayabilir. Bazı depolarda ek LICENSE-MODEL veya NOTICE dosyaları ekstra şartlar getirebilir; üretimde kullanmadan önce bu dosyaları mutlaka kontrol edin.

Gated (Onaylı Erişim) Modeller Nedir?

Bazı modeller indirilmeden önce ek onay gerektirir. Bu süreç genellikle şöyle işler: kullanıcı model sayfasındaki “Agree and access repository” butonuna tıklar, lisans ve kullanım koşullarını kabul eder, bazen kısa bir form doldurur; ardından model sahibi veya otomatik bir sistem erişimi onaylar. Bu mekanizma, ticari kullanımı kontrol etmek, belirli kullanıcı gruplarını (örneğin yalnızca araştırma kurumları) sınırlamak ve yasal uyumluluğu sağlamak için kullanılır. Önemli bir nokta: bu bir ödeme adımı değil, bir uyumluluk kapısıdır. NVIDIA PersonaPlex-7B buna güncel bir örnek: model ağırlıklarına erişim için NVIDIA’nın lisans koşullarının önce kabul edilmesi gerekiyor.

Modeli Paylaştıktan Sonra Ne Olur?

Bir model yayınlandıktan sonra topluluk genellikle şu şekilde etkileşime girer:

• Modeli indirip kendi uygulamalarına entegre eder veya yerel ortamda ince ayar (fine-tuning) yapar.
• Modeli GGUF, ONNX veya TensorRT gibi farklı formatlara dönüştürüp yeniden paylaşır.
• Model kartını ve tartışma sayfasını kullanım örnekleri, hata raporları ve performans karşılaştırmalarıyla zenginleştirir.
• Ticari kullanım ve ince ayar sonrası yükümlülükler hakkında sorular sorup tartışır.

Üretimde kullandığınız modeller için lisansı ve model kartını o spesifik sürüm (revision) için arşivlemeniz, kritik ağırlıkları kendi altyapınıza da yedeklemeniz ve from_pretrained() gibi çağrıları belirli bir revision değerine sabitlemeniz önerilir; çünkü depo veya lisans ileride değişebilir. Hangi model ailelerinin en çok türev ürettiğini ve topluluk trendlerini 2026 topluluk raporumuzda inceleyebilirsiniz.

Sıkça Sorulan Sorular