Space를 ArXiv에 추가하는 방법

Space를 ArXiv에 추가하는 방법

Hugging Face Spaces의 데모는 넓은 사용자가 코드를 작성하지 않고도 최신(state-of-the-art) 머신러닝 연구를 시험해 볼 수 있게 해 줘요. Hugging Face와 ArXiv는 협력하여 이런 데모를 ArXiv의 논문 옆에 직접 임베드하고 있어요!

출처: 문서

본문

이 통합 덕분에 사용자는 이제 논문의 arXiv 초록 페이지에서 그 논문에 대한 가장 인기 있는 데모를 찾을 수 있어요. 예를 들어 LayoutLM 문서 분류 모델의 데모를 시험해 보려면 LayoutLM 논문의 arXiv 페이지로 가서 데모 탭을 열면 돼요. 머신러닝 커뮤니티가 이 모델을 위해 만든 오픈소스 데모가 보이고, 브라우저에서 바로 시험해 볼 수 있어요.

Space를 ArXiv에 추가해 Demos 탭에 표시되게 하는 두 가지 방법을 다룰게요.

사전 요구 사항

  • 데모를 만들고 싶은 ArXiv에 이미 존재하는 논문이 있어야 함
  • Spaces에 모델용 데모를 이미 만들었거나(만들 수 있거나) 있어야 함

방법 1(권장): Space README에서 링크하기

Space를 ArXiv 논문에 추가하는 가장 간단한 방법은 Space README 파일(README.md)에 논문 링크를 포함하는 것이에요. 전체 인용(citation)도 함께 넣는 것이 좋은 관행이에요. 링크와 인용 예시는 이 Echocardiogram Segmentation Space README에서 볼 수 있어요.

이것으로 끝! 몇 분 안에 내 Space가 ArXiv의 논문 옆 Demo 탭에 나타날 거예요 🤗

방법 2: 관련 모델 링크하기

또 다른 접근 방식은 중간 모델을 Space에 링크해 Spaces를 논문에 연결하는 것이에요. 이를 위해서는 논문이 Hugging Face 허브에 있는(또는 업로드할 수 있는) 모델과 연결되어 있어야 해요.

  1. 먼저 ArXiv 논문과 연관된 모델을 아직 없다면 Hugging Face 허브에 업로드하세요.(자세한 지침은 여기)

  2. 모델 카드(README.md)를 작성할 때 ArXiv 논문 링크를 포함하세요. 전체 인용도 함께 넣는 것이 좋아요. 링크·인용 예시는 LayoutLM 모델 카드에서 볼 수 있어요.

    참고: 모델 카드 위에 ArXiv 버튼이 나타나는지 확인하면 이 단계가 성공했는지 알 수 있어요. LayoutLM의 경우 버튼은 "arxiv:1912.13318"이라 쓰여 있고 ArXiv의 LayoutLM 논문으로 연결돼요.

  3. 그다음 이 모델을 로드하는 데모를 Spaces에 만드세요. 코드 어딘가에 모델 이름이 포함되어야 Hugging Face가 그 Space가 모델과 연관되어 있다고 감지할 수 있어요.

    예를 들어 docformer_for_document_classification Space는 LayoutLM을 이렇게 로드하면서 문자열 "microsoft/layoutlm-base-uncased"를 포함합니다:

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

    참고: Hugging Face Spaces에서 데모를 만드는 개요Gradio, Streamlit에 대한 더 구체적인 지침이 있어요.

  4. Space가 build되면 Hugging Face가 그 Space가 모델과 연관되어 있음을 감지해요. Space 오른쪽 위에 "Linked Models" 버튼이 나타납니다.

    참고: Space의 README 메타데이터에서 설명된 대로 연결된 모델을 직접 명시적으로 업데이트해 추가할 수도 있어요.

몇 분 안에 내 Space가 ArXiv의 논문 옆 Demo 탭에 나타날 거예요 🤗

더 알아보기 (Learn more)

  • Spaces 개요에서 데모 빌드의 기초를 배울 수 있어요.
  • 모델 카드에 논문을 링크하는 방법은 모델 업로드 문서에서 확인하세요.