Depolarla Başlama

Bu başlangıç seviyesine uygun kılavuz, Hub'da depolamanızı oluşturmak ve yönetmek için ihtiyacınız olan temel becerileri kazanmanıza yardımcı olacaktır. Her bölüm bir öncekinin üzerine inşa edildiğinden, nereden başlamak isterseniz oradan başlayabilirsiniz!

Gereksinimler

Bu belge, depoların hem web arayüzü hem de terminal üzerinden nasıl yönetileceğini gösterir. Arayüzle çalışırken herhangi bir ön koşul yoktur. Terminalle çalışmak istiyorsanız lütfen bu kurulum talimatlarını izleyin.

git henüz bir komut satırı komutu olarak kullanılamıyorsa, platformunuz için Git'i kurmanız gerekir. Ayrıca, görüntüler ve model ağırlıkları gibi büyük dosyaları işlemek için kullanılacak Git-Xet'i de kurmanız gerekir.

Git üzerinden büyük dosyaları indirmek ve yükleyebilmek için Git Xet eklentisini yüklemeniz gerekir.

Kodunuzu Hub'a göndermek için bir şekilde kimlik doğrulamanız gerekir. Bunu yapmanın en kolay yolu hf CLI'yi kurup login komutunu çalıştırmaktır:

# Install hf:
#   brew install hf
#   or
#   pip install hf
hf auth login

Bu belgenin Başlangıç bölümündeki içerik bir video olarak da mevcuttur!

Depo oluşturma

Hub’ın web arayüzünü kullanarak depolar oluşturabilir, dosyalar ekleyebilir (hatta büyük olanları!), modelleri keşfedebilir, farkları görselleştirebilir ve daha fazlasını yapabilirsiniz. Hub’da üç tür depo bulunur ve bu kılavuzda tanıtım amaçlı bir model deposu oluşturacaksınız. Modelleri, veri kümelerini ve Spaces’leri oluşturma ve yönetme hakkında bilgi için ilgili belgelere başvurun.

1. Yeni bir depo oluşturmak için huggingface.co/new adresini ziyaret edin:

2. Deponun sahibini belirtin: bu, siz veya bağlı olduğunuz kuruluşlardan herhangi biri olabilir.

3. Modelinizin adını girin. Bu, aynı zamanda depoyun adı olacaktır.

4. Modelinizin herkese açık mı yoksa özel mi olmasını istediğinizi belirtin.

5. Lisansı belirtin. Lisans alanını şimdilik boş bırakabilirsiniz. Lisanslar hakkında bilgi edinmek için Lisanslar belgelerine göz atın.

Model depolamanızı oluşturduktan sonra, aşağıdaki gibi bir sayfa görmelisiniz:

Hub, hakkında Model Cards belgeleri'nde bilgi edinebileceğiniz bir Model Card oluşturmaya sizi yönlendirir. Model deposuna bir Model Card eklemek en iyi uygulamalardan biridir, ancak şu an yalnızca bir test deposu oluşturduğumuz için bunu atlayabiliriz.

Bir depoya dosya ekleme (Web arayüzü)

Web arayüzü üzerinden deponuza dosya eklemek için önce Files sekmesini seçin, hedef dizine gidin ve ardından Add file düğmesine tıklayın. Yeni bir dosya oluşturma veya dosyayı doğrudan bilgisayarınızdan yükleme seçeneği sunulacaktır.

Yeni bir dosya oluşturma

Yeni bir dosya oluşturmaya karar verirseniz, dosyanıza bir ad seçebileceğiniz, içerik ekleyebileceğiniz ve değişikliklerinizi özetleyen bir mesajla dosyanızı kaydedebileceğiniz aşağıdaki düzenleyici ekranına yönlendirilirsiniz. Yeni dosyayı doğrudan repozituarınızın main dalına eklemek yerine, bir Pull Request oluşturmak için Open as a pull request seçeneğini seçebilirsiniz.

Bir dosya yükleme

Dosya yükle seçeneğini seçerseniz, depoya yaptığınız değişiklikleri özetleyen bir mesajla birlikte yüklemek için yerel bir dosya seçebilirsiniz.

Yeni dosya oluşturmada olduğu gibi, değişikliklerinizi doğrudan repozitorinizin main dalına eklemek yerine bir Pull Request oluşturmak için Open as a pull request seçeneğini seçebilirsiniz.

Depoya dosya ekleme (CLI)

Dosyaları hf CLI kullanarak doğrudan terminalden deponuza yükleyebilirsiniz. Yerel dosyaları veya tüm klasörleri göndermek için hf upload komutunu kullanın:

# Upload a single file to your model repo
hf upload your-username/your-model-name model.safetensors

# Upload an entire directory
hf upload your-username/your-model-name ./my-model-directory

# Upload to a dataset repo
hf upload your-username/your-dataset-name ./data --repo-type dataset

hf CLI büyük dosyaları otomatik olarak işler — ek bir kurulum gerekmez.

Bir depoya dosya ekleme (git)

Depoları klonlama

Depoları yerel makinenize indirmek kopyalama olarak adlandırılır. Deponuzu yüklemek ve içine geçmek için aşağıdaki komutları kullanabilirsiniz:

git clone https://huggingface.co/<your-username>/<your-model-name>
cd <your-model-name>

Veya bir veri seti deposu için:

git clone https://huggingface.co/datasets/<your-username>/<your-dataset-name>
cd <your-dataset-name>

Aşağıdaki komutla SSH üzerinden klonlayabilirsiniz:

git clone git@hf.co:<your-username>/<your-model-name>
cd <your-model-name>

Değişiklikleri göndermek veya özel depolara erişmek için SSH anahtarınızı kullanıcı ayarlarınıza eklemeniz gerekir.

Kurulum

Şimdi tam zamanı, istediğiniz dosyaları depoya ekleyebilirsiniz! 🔥

10MB'dan büyük dosyalarınız var mı? Bu dosyalar, şu komutla başlatabileceğiniz git-xet ile izlenmelidir:

git xet install

Hugging Face kullanarak bir depo oluşturduğunuzda, Hugging Face, .gitattributes dosyasında yaygın Makine Öğrenimi büyük dosyaları için yaygın dosya uzantılarının listesini otomatik olarak sağlar; git-xet bu dosyayı büyük dosyalarınızdaki değişiklikleri verimli bir şekilde izlemek için kullanır. Ancak dosya türleriniz zaten işlenmiyorsa yeni uzantılar eklemeniz gerekebilir. Bunu git xet track "*.your_extension" komutuyla yapabilirsiniz.

Dosyaları gönderme

Git'i, yeni dosyaları ve mevcut dosyalardaki değişiklikleri, projenize bir “revizyon” olarak düşünülebilen commit adı verilen bir değişiklik paketi olarak kaydetmek için kullanabilirsiniz. Bir commit oluşturmak için, değişiklikleri kaydetmeyi planladığımızı Git'e bildirmek üzere dosyaları add etmeniz ve ardından bu değişiklikleri commit etmeniz gerekir. Yeni commit'i Hugging Face Hub ile senkronize etmek için commit'i Hub'a push etmeniz yeterlidir.

# Create any files you like! Then...
git add .
git commit -m "First model version"  # You can choose any descriptive message
git push

Ve işte bitti! Hugging Face'teki deposunu, son eklenen tüm dosyalarla birlikte kontrol edebilirsin. Örneğin, aşağıdaki ekran görüntüsünde kullanıcı bir dizi dosya ekledi. Bu örnekteki bazı dosyaların boyutu 1.04 GB olduğundan, depo bunu izlemek için Xet kullanır.

Depoyu HTTP ile klonladıysanız, her push işleminde kullanıcı adınızı ve şifrenizi girmeniz istenebilir. Tekrarı önlemenin en basit yolu, HTTP yerine SSH'ye geçmektir. Alternatif olarak, HTTP kullanmak zorundaysanız, kullanıcı adınızı ve şifrenizi otomatik doldurmak için bir git credential helper yapılandırmak işinize yarayabilir.

Bir depoyun geçmişini görüntüleme

Her add-commit-push döngüsünde, depo dosyalarınıza yaptığınız her değişikliği takip eder. Arayüz, model dosyalarını ve commit’leri incelemenize ve her commit’in getirdiği farkı (ayn zamanda diff olarak bilinir) görmenize olanak tanır. Geçmişi görmek için History: X commits bağlantısına tıklayabilirsiniz.

Bir commit'in o commit'in getirdiği değişiklikleri görmek için üzerine tıklayabilirsiniz: