Cách thêm một Space vào ArXiv

Các demo trên Hugging Face Spaces cho phép một lượng lớn người dùng trải nghiệm các nghiên cứu machine learning tiên tiến mà không cần viết bất kỳ dòng code nào. Hugging Face và ArXiv đã hợp tác để nhúng các demo này trực tiếp bên cạnh các bài báo trên ArXiv!

Nhờ có tích hợp này, người dùng giờ đây có thể tìm thấy các demo phổ biến nhất cho một bài báo ngay trên trang tóm tắt arXiv của nó. Ví dụ, nếu bạn muốn thử các demo của mô hình phân loại tài liệu LayoutLM, bạn có thể truy cập trang arXiv của bài báo LayoutLM và chuyển đến tab demo. Bạn sẽ thấy các demo mã nguồn mở do cộng đồng machine learning xây dựng cho mô hình này, có thể chạy thử ngay trong trình duyệt:

Chúng ta sẽ xem xét hai cách khác nhau để thêm Space của bạn vào ArXiv và hiển thị nó trong tab Demos.

Điều kiện tiên quyết

• Có một bài báo hiện có trên ArXiv mà bạn muốn tạo một bản demo
• Bạn đã xây dựng (hoặc có thể xây dựng) một demo cho mô hình trên Spaces

Phương pháp 1 (Được khuyến nghị): Liên kết từ README của Space

Cách đơn giản nhất để thêm một Space vào một bài báo ArXiv là bao gồm liên kết đến bài báo trong tệp README của Space (README.md). Tốt nhất nên bao gồm cả trích dẫn đầy đủ. Bạn có thể xem một ví dụ về liên kết và trích dẫn trong tệp README của Space Phân đoạn Siêu âm tim này.

Và như vậy là xong! Space của bạn sẽ xuất hiện trong tab Demo bên cạnh bài báo trên ArXiv sau vài phút 🤗

Phương pháp 2: Liên kết một mô hình liên quan

Một cách tiếp cận thay thế có thể được sử dụng để liên kết Spaces với các bài báo bằng cách liên kết một mô hình trung gian với Space. Điều này yêu cầu bài báo phải được liên kết với một mô hình có trên Hugging Face Hub (hoặc có thể được tải lên đó)

1. Đầu tiên, hãy tải lên Hugging Face Hub mô hình liên quan đến bài báo ArXiv nếu nó chưa có sẵn. (Các hướng dẫn chi tiết nằm tại đây)

2. Khi viết thẻ mô hình (README.md) cho mô hình, hãy bao gồm một liên kết đến bài báo ArXiv. Tốt nhất là cũng nên bao gồm một trích dẫn đầy đủ. Bạn có thể xem một ví dụ về liên kết và trích dẫn trên thẻ mô hình LayoutLM

   Lưu ý: bạn có thể xác nhận bước này đã được thực hiện thành công bằng cách kiểm tra xem có nút ArXiv xuất hiện phía trên thẻ mô hình hay không. Trong trường hợp của LayoutLM, nút này ghi: “arxiv:1912.13318” và liên kết đến bài báo LayoutLM trên ArXiv.

   

3. Sau đó, tạo một demo trên Spaces để tải model này. Ở đâu đó trong mã, tên model phải được bao gồm để Hugging Face có thể phát hiện rằng một Space được liên kết với nó.

   Ví dụ, Space docformer_for_document_classification nạp LayoutLM như sau và bao gồm chuỗi "microsoft/layoutlm-base-uncased":

   Đã sao chép

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

   Lưu ý: Dưới đây là tổng quan về việc xây dựng demo trên Hugging Face Spaces và đây là các hướng dẫn cụ thể hơn cho Gradio và Streamlit.

4. Ngay khi Space của bạn được xây dựng xong, Hugging Face sẽ phát hiện ra rằng nó liên kết với model. Nút “Linked Models” sẽ xuất hiện ở góc trên bên phải của Space, như được minh họa ở đây:

   

   Lưu ý: Bạn cũng có thể thêm các model liên kết thủ công bằng cách cập nhật chúng một cách rõ ràng trong metadata README của Space, như được mô tả tại đây.

Space của bạn sẽ xuất hiện trong tab Demo bên cạnh bài báo trên ArXiv sau vài phút 🤗

Update on GitHub