Hub 文档
如何在 ArXiv 中添加 Space
并获得增强的文档体验
开始使用
如何在 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 上(或可以上传到那里)的模型相关联
首先,如果与 ArXiv 论文相关的模型尚未在 Hugging Face Hub 上,请将其上传到 Hugging Face Hub。(详细说明在此)
在为模型编写模型卡片 (README.md) 时,请包含指向 ArXiv 论文的链接。最佳实践是同时包含完整的引用。您可以在 LayoutLM 模型卡片上查看链接和引用的示例
注意:您可以通过查看模型卡片上方是否出现 ArXiv 按钮来验证此步骤是否已成功执行。在 LayoutLM 的情况下,按钮显示:“arxiv:1912.13318” 并链接到 ArXiv 上的 LayoutLM 论文。
然后,在 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 的更具体说明。
一旦您的 Space 构建完成,Hugging Face 将检测到它与模型相关联。Space 的右上角应出现一个“链接模型”按钮,如此处所示
注意:您还可以通过在 Space 的 README 元数据中显式更新链接模型来手动添加链接模型,如此处所述。
您的 Space 应该会在几分钟后 🤗 出现在 ArXiv 上论文旁边的演示选项卡中
< > 在 GitHub 上更新