Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

使用 Hugging Face 登录

您可以使用 HF OAuth / OpenID 连接流程在任何网站或应用程序中创建“使用 HF 登录”流程。

这将允许用户通过单击类似于此按钮的按钮,使用他们的 HF 帐户登录您的网站或应用程序

Sign in with Hugging Face

单击此按钮后,您的用户将看到一个权限模态框,以授权您的应用程序

创建 OAuth 应用

您可以在您的设置中创建您的应用程序

如果您在 Spaces 中托管

如果您在 Spaces 上托管您的应用程序,那么流程将更容易实现(并且直接内置于 Gradio 中);请查看我们的 Spaces OAuth 指南

当前支持的 scopes

当前支持的 scopes 包括

  • openid:除了访问令牌外,还获取 ID 令牌。
  • profile:获取用户的个人资料信息(用户名、头像等)
  • email:获取用户的电子邮件地址。
  • read-billing:了解用户是否设置了付款方式。
  • read-repos:获取用户个人仓库的读取权限。
  • write-repos:获取用户个人仓库的写入/读取权限。
  • manage-repos:获取用户个人仓库的完全访问权限。还授予仓库创建和删除权限。
  • inference-api:访问 Inference API,您将能够代表用户发出推理请求。
  • write-discussions:代表用户发起讨论和拉取请求,以及与讨论互动(包括回复、发布/编辑评论、关闭讨论等)。要在私有仓库上打开拉取请求,您还需要请求 read-repos scope。

所有其他信息都可以在 OpenID 元数据中找到。

如果您需要任何额外的 scopes,请联系我们。

访问组织资源

默认情况下,oauth 应用不需要访问组织资源。

但是某些 scopes(如 read-repos 或 read-billing)也适用于组织。

用户可以在授权应用时选择要授予访问权限的组织。如果您需要访问特定组织,您可以将 orgIds=ORG_ID 作为查询参数添加到 OAuth 授权 URL。您必须将 ORG_ID 替换为组织 ID,该 ID 在 userinfo 响应的 organizations.sub 字段中可用。

品牌

您可以自由使用您自己的按钮设计。下面提供了一些有用的 SVG 图像。

查看我们的徽章,其中包含在 markdown 或 HTML 中集成它们的说明。

Sign in with Hugging Face Sign in with Hugging Face

Sign in with Hugging Face Sign in with Hugging Face

Sign in with Hugging Face Sign in with Hugging Face

Sign in with Hugging Face Sign in with Hugging Face

< > 更新 在 GitHub 上