Hub 文档

如何在 ArXiv 中添加 Space

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

如何在 ArXiv 中添加 Space

Hugging Face Spaces 上的演示允许广泛的受众尝试最先进的机器学习研究,而无需编写任何代码。Hugging Face 和 ArXiv 合作,将这些演示直接嵌入到 ArXiv 上的论文旁边!

由于这种集成,用户现在可以在 arXiv 摘要页面上找到论文最受欢迎的演示。例如,如果您想尝试 LayoutLM 文档分类模型的演示,您可以访问 LayoutLM 论文的 arXiv 页面,并导航到演示选项卡。您将看到机器学习社区为该模型构建的开源演示,您可以立即在浏览器中试用

我们将介绍两种不同的方法将您的 Space 添加到 ArXiv,并使其显示在演示选项卡中。

先决条件

  • ArXiv 上已有一篇您想为其创建演示的论文
  • 您已经构建或(可以构建)模型在 Spaces 上的演示

方法 1(推荐):从 Space README 链接

将 Space 添加到 ArXiv 论文的最简单方法是将论文链接包含在 Space README 文件 (README.md) 中。最佳实践是同时包含完整的引用。您可以在此 Echocardiogram Segmentation Space README 上查看链接和引用的示例。

就是这样!您的 Space 应该会在几分钟后 🤗 出现在 ArXiv 上论文旁边的演示选项卡中

方法 2:链接相关模型

可以使用另一种方法通过将中间模型链接到 Space,从而将 Spaces 链接到论文。这要求论文与 Hugging Face Hub 上(或可以上传到那里)的模型相关联

  1. 首先,如果与 ArXiv 论文相关的模型尚未在 Hugging Face Hub 上,请将其上传到 Hugging Face Hub。(详细说明在此

  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 上构建演示的概述,这里有关于 GradioStreamlit 的更具体说明。

  4. 一旦您的 Space 构建完成,Hugging Face 将检测到它与模型相关联。Space 的右上角应出现一个“链接模型”按钮,如此处所示

    注意:您还可以通过在 Space 的 README 元数据中显式更新链接模型来手动添加链接模型,如此处所述

您的 Space 应该会在几分钟后 🤗 出现在 ArXiv 上论文旁边的演示选项卡中

< > 在 GitHub 上更新