Hub documentation

Cara Menambahkan Space ke ArXiv

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Cara Menambahkan Space ke ArXiv

Demos di Hugging Face Spaces memungkinkan audiens yang luas untuk mencoba penelitian machine learning terkini tanpa perlu menulis kode. Hugging Face dan ArXiv telah berkolaborasi untuk menyematkan demos ini langsung di samping paper di ArXiv!

Berkat integrasi ini, pengguna kini dapat menemukan demo paling populer untuk sebuah paper di halaman abstrak arXiv-nya. Misalnya, jika Anda ingin mencoba demo model klasifikasi dokumen LayoutLM, Anda dapat membuka halaman arXiv paper LayoutLM, lalu menavigasi ke tab demo. Anda akan melihat demo open-source yang dibangun oleh komunitas machine learning untuk model ini, yang dapat langsung dicoba di browser Anda:

Kami akan membahas dua cara berbeda untuk menambahkan Space Anda ke ArXiv dan memunculkannya di tab Demos.

Prasyarat

  • Ada makalah yang sudah ada di ArXiv yang ingin Anda buat demonya
  • Anda telah membangun atau (dapat membangun) demo untuk model di Spaces

Metode 1 (Disarankan): Tautan dari README Space

Cara termudah untuk menambahkan Space ke makalah ArXiv adalah dengan menyertakan tautan ke makalah tersebut dalam file README Space (README.md). Praktik yang baik adalah juga menyertakan sitasi lengkap. Anda dapat melihat contoh tautan dan sitasi pada README Space Echocardiogram Segmentation ini.

Dan selesai! Space Anda seharusnya muncul di tab Demo di samping paper di ArXiv dalam beberapa menit 🤗

Metode 2: Mengaitkan Model Terkait

Pendekatan alternatif dapat digunakan untuk menghubungkan Spaces ke makalah dengan cara menghubungkan model perantara ke Space. Hal ini mensyaratkan bahwa makalah tersebut terkait dengan model yang ada di Hugging Face Hub (atau dapat diunggah ke sana)

  1. Pertama, unggah model yang terkait dengan paper ArXiv ke Hugging Face Hub jika belum ada. (Panduan terperinci ada di sini)

  2. Saat menulis model card (README.md) untuk model, sertakan tautan ke paper ArXiv. Praktik yang baik adalah menyertakan sitasi lengkap juga. Anda dapat melihat contoh tautan dan sitasi pada model card LayoutLM

    Catatan: Anda dapat memverifikasi bahwa langkah ini telah berhasil dilakukan dengan melihat apakah tombol ArXiv muncul di atas kartu model. Dalam kasus LayoutLM, tombol tersebut bertuliskan: “arxiv:1912.13318” dan mengarah ke makalah LayoutLM di ArXiv.

  3. Lalu, buat demo di Spaces yang memuat model ini. Di suatu tempat dalam kode, nama model harus disertakan agar Hugging Face dapat mendeteksi bahwa sebuah Space terkait dengannya.

    Sebagai contoh, Space docformer_for_document_classification memuat LayoutLM seperti ini dan menyertakan string "microsoft/layoutlm-base-uncased":

    from transformers import LayoutLMForTokenClassification
    
    layoutlm_dummy = LayoutLMForTokenClassification.from_pretrained("microsoft/layoutlm-base-uncased", num_labels=1)

    Catatan: Berikut adalah ringkasan tentang membangun demo di Hugging Face Spaces dan berikut adalah instruksi yang lebih spesifik untuk Gradio dan Streamlit.

  4. Begitu Space Anda selesai dibangun, Hugging Face akan mendeteksi bahwa Space tersebut terkait dengan model. Tombol “Linked Models” seharusnya muncul di sudut kanan atas Space, seperti yang ditunjukkan di sini:

    Catatan: Anda juga dapat menambahkan model terkait secara manual dengan memperbarui secara eksplisit di metadata README untuk Space, seperti yang dijelaskan di sini.

Space Anda seharusnya muncul di tab Demo di samping paper di ArXiv dalam beberapa menit 🤗

Update on GitHub