🗂️ 本地运行 Sheets
现在你已经尝试在 Hugging Face Hub 上使用 Sheets,你可能想在本地运行它。
本文将指导你如何使用 Docker 在本地运行 Sheets。这将允许你在自己的机器上创建和管理数据集,并能够使用 Hugging Face 模型生成内容。
要求
由于 Sheets 是一个基于 Docker 的应用程序,你只需在你的机器上安装 Docker。你可以在 Docker 官网上找到适用于你的操作系统的安装说明。
运行 Sheets
要在本地运行 Sheets,你可以使用以下命令:
docker run -p 3000:3000 \
-e HF_TOKEN=<your_huggingface_token> \
aisheets/sheets
请务必将 <your_huggingface_token>
替换为有效的 Hugging Face token,该 token 至少具有 inference
访问权限才能使用 Sheets 生成内容。你可以访问 Hugging Face 账户设置 创建 token。
执行命令后,你可以在网络浏览器中访问 https://:3000
来访问 Sheets。你将看到 Sheets 界面,然后就可以开始使用它来创建和管理你的电子表格。
此配置允许你将 Sheets 与单个已连接用户一起使用。如果你想让 Sheets 支持多个用户,可以按照下一节的说明设置 OAuth 认证。
OAuth 认证
要让 Sheets 支持多用户,你必须设置 OAuth 认证。这允许用户使用他们的 Hugging Face 账户登录并管理他们的数据。
你需要创建一个 Hugging Face 应用程序并获取客户端 ID。为此,请访问你的 Hugging Face 账户设置并创建一个新的 OAuth 应用程序。
为应用程序添加 manage-repos
和 inference-api
范围,以允许用户发布其数据并使用推理 API。
将重定向 URL https://:3000/auth/callback
添加到应用程序设置中。这是用户使用 Hugging Face 账户登录后将被重定向到的 URL。
获得客户端 ID 后,你可以使用以下命令运行带有 OAuth 认证的 Sheets:
docker run -p 3000:3000 \
-e OAUTH_CLIENT_ID=<your_hf_application_client_id> \
-e HF_TOKEN=<your_huggingface_token> \
-e OAUTH_HTTPS_ONLY=0 \
aisheets/sheets
请务必将 <your_hf_application_client_id>
替换为你的 Hugging Face 应用程序的客户端 ID。
仍然需要 HF_TOKEN
环境变量以允许匿名用户访问推理 API 并生成内容。你可以使用之前创建的同一 token。如果你不想使用 token,可以删除 HF_TOKEN
环境变量,但用户将无法在未登录 Hugging Face 账户的情况下生成内容。
OAUTH_HTTPS_ONLY
环境变量设置为 0
以允许在本地运行时进行 HTTP 重定向。如果你想在强制 HTTPS 的生产环境中运行 Sheets,应将 OAUTH_HTTPS_ONLY
设置为 1
,或者直接将其删除,因为默认值为 1
。
积分使用注意事项
在本地运行 Sheets 时,你将使用你的 Hugging Face 账户访问推理提供商。这意味着 Sheets 生成的任何内容都将消耗你的 Hugging Face 积分。
请务必监控你的积分使用情况并进行相应调整。请记住使用 Hugging Face 账单仪表盘 查看你的积分使用情况并管理你的订阅。
启用网页搜索
Sheets 还可以执行网页搜索以增强内容生成过程。为此,Sheets 使用 serper
库,该库需要 API 密钥才能访问网页搜索功能。
你需要获取一个 Serper API 密钥才能在 Sheets 中启用网页搜索。你可以在 Serper 官网上获取你的 API 密钥并注册免费账户。
获取 Serper API 密钥后,你可以使用以下命令运行启用网页搜索的 Sheets:
docker run -p 3000:3000 \
-e SERPER_API_KEY=<your_serper_api_key> \
...
aisheets/sheets
结论
在本地运行 Sheets 非常简单。它允许你借助 Hugging Face 模型的强大功能创建和管理表格。按照本指南中概述的步骤,你可以在你的机器上设置 Sheets 并高效地生成内容。
请监控你的 Hugging Face 积分使用情况,如果你升级到 PRO,你每月将获得 2 美元免费积分。如果你有任何问题或需要进一步的帮助,请随时在 Hugging Face Sheets 空间中发起新的讨论。