Hub 文档

如何将Space添加到ArXiv

Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

如何将 Space 添加到 ArXiv

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

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

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

先决条件

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

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

将 Space 添加到 ArXiv 论文的最简单方法是在 Space README 文件(README.md)中包含该论文的链接。同时包含完整的引用也是一个好习惯。您可以在此超声心动图分割 Space README 上查看链接和引用的示例。

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

方法 2:链接相关模型

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

  1. 首先,如果尚未上传,请将与 ArXiv 论文相关的模型上传到 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 上更新