Transformers documentation
Berbagi
Berbagi
Hub Hugging Face adalah platform untuk berbagi, menemukan, dan menggunakan model dengan berbagai jenis dan ukuran. Kami sangat menyarankan Anda untuk membagikan model Anda di Hub guna mendorong kemajuan machine learning open-source untuk semua orang!
Panduan ini akan menunjukkan cara berbagi model ke Hub dari Transformers.
Persiapan
Untuk membagikan model ke Hub, Anda memerlukan akun Hugging Face. Buat User Access Token (disimpan di cache secara default) dan masuk ke akun Anda dari command line atau notebook.
hf auth login
from huggingface_hub import notebook_login
notebook_login()Fitur repository
Setiap repositori model memiliki fitur versioning, riwayat commit, dan visualisasi diff.

Versioning didasarkan pada Git dan Git Large File Storage (LFS), dan memungkinkan revisi, yaitu cara untuk menentukan versi model dengan commit hash, tag, atau branch.
Sebagai contoh, gunakan parameter revision di from_pretrained() untuk memuat versi model tertentu dari hash commit.
model = AutoModel.from_pretrained(
"julien-c/EsperBERTo-small", revision="4c77982"
)Memuat dari branch atau tag mengunci setiap file dalam panggilan tersebut ke satu commit, lalu mengambil setiap file dari commit tersebut.
Pin tersebut hanya berlaku selama panggilan. Untuk reproduktibilitas antar eksekusi, berikan hash commit eksplisit atau tag yang Anda perlakukan sebagai tetap. Jangan andalkan main atau cabang bergerak lainnya untuk tetap stabil antar eksekusi.
Repositori model juga mendukung gating untuk mengontrol siapa yang dapat mengakses sebuah model. Gating umum digunakan untuk memungkinkan sekelompok pengguna tertentu menguji coba model penelitian sebelum model tersebut dirilis ke publik.

Repositori model juga mencakup widget inferensi agar pengguna dapat berinteraksi langsung dengan model di Hub.
Lihat dokumentasi Model Hub untuk informasi lebih lanjut.
Mengunggah model
Terdapat beberapa cara untuk mengunggah model ke Hub, tergantung pada preferensi alur kerja Anda. Anda dapat mendorong model dengan Trainer, memanggil push_to_hub() secara langsung pada model, atau menggunakan antarmuka web Hub.
Trainer
Trainer dapat mendorong model secara langsung ke Hub setelah pelatihan. Atur push_to_hub=True di TrainingArguments dan teruskan ke Trainer. Setelah pelatihan selesai, panggil push_to_hub() untuk mengunggah model.
push_to_hub() secara otomatis menambahkan informasi yang berguna seperti hiperparameter pelatihan dan hasil ke model card.
from transformers import TrainingArguments, Trainer
training_args = TrainingArguments(output_dir="my-awesome-model", push_to_hub=True)
trainer = Trainer(
model=model,
args=training_args,
train_dataset=small_train_dataset,
eval_dataset=small_eval_dataset,
compute_metrics=compute_metrics,
)
trainer.push_to_hub()Untuk mengunggah model ke repositori privat, atur hub_private_repo=True di TrainingArguments. Jika repositori belum dibuat (misalnya, ketika push_to_hub=False di TrainingArguments), Anda juga dapat meneruskan private=True ke push_to_hub() sebagai gantinya. Argumen private hanya berlaku saat repositori dibuat, sehingga tidak mengubah visibilitas repositori yang sudah ada.
trainer.push_to_hub(private=True)PushToHubMixin
PushToHubMixin menyediakan fungsionalitas untuk mendorong model atau tokenizer ke Hub.
Panggil push_to_hub() langsung pada model untuk mengunggahnya ke Hub. Fungsi ini membuat repositori di bawah namespace Anda dengan nama model yang ditentukan dalam push_to_hub().
model.push_to_hub("my-awesome-model")Objek lain seperti tokenizer juga didorong ke Hub dengan cara yang sama.
tokenizer.push_to_hub("my-awesome-model")Profil Hugging Face Anda seharusnya sekarang menampilkan repositori model yang baru dibuat. Pergi ke tab Files untuk melihat semua file yang diunggah.
Lihat panduan Upload files to the Hub untuk informasi lebih lanjut tentang cara mendorong file ke Hub.
Antarmuka web Hub
Antarmuka web Hub adalah pendekatan tanpa kode untuk mengunggah model.
- Buat repositori baru dengan memilih New Model.

Tambahkan beberapa informasi tentang model Anda:
- Pilih owner dari repositori. Ini bisa diri Anda sendiri atau salah satu organisasi yang Anda ikuti.
- Pilih nama untuk model Anda, yang juga akan menjadi nama repositori.
- Pilih apakah model Anda bersifat publik atau privat.
- Atur penggunaan lisensi.
Klik Buat model untuk membuat repositori model.
Pilih tab Files dan klik tombol Add file untuk menyeret dan melepas file ke repositori Anda. Tambahkan pesan commit dan klik Commit changes to main untuk meng-commit file tersebut.

Kartu model
Kartu model memberi tahu pengguna tentang kinerja model, keterbatasannya, potensi bias, dan pertimbangan etika. Sangat disarankan untuk menambahkan kartu model ke repositori Anda!
Model card adalah file README.md di repositori Anda. Tambahkan file ini dengan cara:
- membuat dan mengunggah file
README.mdsecara manual - mengklik tombol Edit model card di repositori
Lihat model card Llama 3.1 sebagai contoh tentang apa yang perlu disertakan dalam model card.
Pelajari lebih lanjut tentang metadata kartu model lainnya (emisi karbon, lisensi, tautan ke paper, dll.) yang tersedia di panduan Model Cards.
Update on GitHub