Hub documentation

ArXiv'e Bir Space Ekleme

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

ArXiv'e Bir Space Ekleme

Hugging Face Spaces'teki demolar, kod yazmadan en son makine öğrenmesi araştırmalarını geniş bir kitleye deneme imkanı sunar. Hugging Face ve ArXiv, bu demoları ArXiv'deki makalelerin hemen yanında yerleştirmek için iş birliği yapmıştır!

Bu entegrasyon sayesinde kullanıcılar artık bir makalenin en popüler demolarını arXiv özet sayfasında bulabilir. Örneğin, LayoutLM belge sınıflandırma modelinin demolarını denemek istiyorsanız, LayoutLM makalesinin arXiv sayfasına gidip demo sekmesine geçebilirsiniz. Bu model için makine öğrenmesi topluluğu tarafından oluşturulan ve tarayıcınızda anında deneyebileceğiniz açık kaynaklı demoları göreceksiniz:

Space'inizi ArXiv'e eklemenin ve Demos sekmesinde görünmesini sağlamanın iki farklı yolunu ele alacağız.

Ön Gereksinimler

  • ArXiv'de, bir demo oluşturmak istediğiniz mevcut bir makale var
  • Spaces üzerinde model için bir demo oluşturduğunuzu (veya oluşturabileceğinizi) belirtin

Yöntem 1 (Önerilen): Space README'sinden Bağlantı Verme

Bir ArXiv makalesine Space eklemenin en basit yolu, makalenin bağlantısını Space README dosyasına (README.md) eklemektir. Tam bir atıf eklemek de iyi bir uygulamadır. Bağlantı ve atıf örneğini bu Echocardiogram Segmentation Space README dosyasında görebilirsiniz.

Ve tamam! Birkaç dakika içinde ArXiv'deki makalenin yanındaki Demo sekmesinde Space'iniz görünecek 🤗

Yöntem 2: İlgili Bir Modeli Bağlama

Spaces ile makaleleri ilişkilendirmek için ara bir modeli Space'e bağlayarak alternatif bir yaklaşım kullanılabilir. Bunun için, makalenin Hugging Face Hub'da bulunan (veya oraya yüklenebilen) bir modelle ilişkilendirilmiş olması gerekir.

  1. Öncelikle, ArXiv makalesiyle ilişkili model Hugging Face Hub'da yoksa oraya yükleyin. (Ayrıntılı talimatlar burada)

  2. Model için model kartını (README.md) yazarken, ArXiv makalesine bir bağlantı ekleyin. Tam bir atıf eklemek de iyi bir uygulamadır. Bir bağlantı ve atıf örneğini LayoutLM model kartında görebilirsiniz.

    Not: Bu adımın başarıyla gerçekleştirildiğini, model kartının üstünde bir ArXiv düğmesinin görünüp görünmediğini kontrol ederek doğrulayabilirsiniz. LayoutLM durumunda düğme “arxiv:1912.13318” yazar ve ArXiv üzerindeki LayoutLM makalesine bağlantı verir.

  3. Ardından, bu modeli yükleyen bir Spaces demosu oluşturun. Bir Space'in bu modelle ilişkili olduğunu Hugging Face'in tespit edebilmesi için model adı, kodun bir yerinde yer almalıdır.

    Örneğin, docformer_for_document_classification Space, LayoutLM'yi şu şekilde yükler ve "microsoft/layoutlm-base-uncased" dizesini içerir:

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

    Not: Hugging Face Spaces üzerinde demo oluşturmaya dair bir genel bakış ve Gradio ile Streamlit için daha spesifik talimatlar burada.

  4. Space'iniz oluşturulur oluşturulmaz Hugging Face, modelle ilişkili olduğunu algılar. Burada gösterildiği gibi, Space'in sağ üst köşesinde “Linked Models” düğmesi görünmelidir:

    Note: README metadata for the Space, as described here bölümünde belirtildiği gibi, Space'in README metadata'sını açıkça güncelleyerek bağlı modelleri manuel olarak da ekleyebilirsiniz.

Space'iniz birkaç dakika içinde ArXiv'deki makalenin yanında Demo sekmesinde görünecek 🤗

Update on GitHub