Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

使用 Hugging Face 登录

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

这将允许用户通过单击类似此按钮来使用其 HF 账户登录您的网站或应用程序

Sign in with Hugging Face

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

创建 OAuth 应用

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

如果您在 Spaces 中托管

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

当前支持的范围

当前支持的范围是

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

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

如果您需要任何额外的权限范围,请联系我们。

访问组织资源

默认情况下,OAuth 应用程序无需访问组织资源。

但是,某些范围,如 `read-repos` 或 `read-billing` 也适用于组织。

用户在授权应用程序时可以选择授予哪些组织访问权限。如果您需要访问特定的组织,您可以在 OAuth 授权 URL 中添加 `orgIds=ORG_ID` 作为查询参数。您必须将 `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 上更新