Hugging Face's logo
加入 Hugging Face 社区

并获取增强型文档体验

开始使用

Spaces 配置参考

Spaces 通过存储库根目录下 **README.md** 文件顶部的 YAML 代码块进行配置。下面列出了所有接受的参数。

title : string
Space 的显示标题。

emoji : string
Space 表情符号(只允许表情符号字符)。

colorFrom : string
缩略图渐变的颜色(红色、黄色、绿色、蓝色、靛蓝色、紫色、粉色、灰色)。

colorTo : string
缩略图渐变的颜色(红色、黄色、绿色、蓝色、靛蓝色、紫色、粉色、灰色)。

sdk : string
可以是 gradiostreamlitdockerstatic 中的一种。

python_version: string
任何有效的 Python 3.x3.x.x 版本。
默认为 3.10

sdk_version : string
指定所选 SDK(Streamlit 或 Gradio)的版本。
支持所有版本的 Gradio。
支持从 0.79.0 开始的所有版本的 Streamlit。

suggested_hardware : string
指定此 Space 必须运行的建议 硬件
对于旨在被其他用户复制的 Spaces 很有用。
设置此值不会自动将硬件分配给此 Space。
值必须是有效的硬件类型。当前有效的硬件类型

  • CPU: "cpu-basic", "cpu-upgrade"
  • GPU: "t4-small", "t4-medium", "l4x1", "l4x4", "a10g-small", "a10g-large", "a10g-largex2", "a10g-largex4","a100-large"
  • TPU: "v5e-1x1", "v5e-2x2", "v5e-2x4"

suggested_storage : string
指定此 Space 必须运行的建议 永久存储
对于旨在被其他用户复制的 Spaces 很有用。
设置此值不会自动将永久存储分配给此 Space。
值必须是 "small""medium""large" 之一。

app_file : string
指向你的主要应用程序文件(包含 gradiostreamlit Python 代码,或 static html 代码)的路径。
路径相对于存储库的根目录。

app_port : int
应用程序运行的端口。仅在 sdkdocker 时使用。默认端口为 7860

base_path: string 对于非静态 Spaces,用于渲染的初始 URL。需要以 / 开头。对于静态 Spaces,请改用 app_file

fullWidth: boolean
你的 Space 是否在 iframe 内以全宽(如果为 true)或固定宽度列(即“容器”CSS)渲染。默认为 true

header: string
可以是 minidefault 之一。如果将 header 设置为 mini,则 Space 将以全屏模式显示,并带有小型浮动标题。

short_description: string Space 的简短描述。这将显示在 Space 的缩略图中。

models : List[string]
Space 中使用的 HF 模型 ID(如 openai-community/gpt2deepset/roberta-base-squad2)。如果此处未指定,将从你的代码中自动解析。

datasets : List[string]
Space 中使用的 HF 数据集 ID(如 mozilla-foundation/common_voice_13_0oscar-corpus/OSCAR-2109)。如果此处未指定,将从你的代码中自动解析。

tags : List[string]
描述你的 Space 任务或范围的术语列表。

thumbnail: string
用于定义用于社交分享的自定义缩略图的 URL。

pinned : boolean
Space 是否停留在你的个人资料顶部。如果你有很多 Spaces,这可能很有用,这样你和其他用户可以快速查看你最好的 Space。

hf_oauth : boolean
是否有连接的 OAuth 应用与此 Space 相关联。有关更多详细信息,请参阅 在你的 Space 中添加使用 HF 登录按钮

hf_oauth_scopes : List[string] 连接的 OAuth 应用的授权范围。默认情况下,openidprofile 已授权,不需要此参数。有关更多详细信息,请参阅 在你的 Space 中添加使用 HF 登录按钮

hf_oauth_expiration_minutes : int OAuth 令牌的持续时间(以分钟为单位)。默认为 480 分钟(8 小时)。最长持续时间为 43200 分钟(30 天)。有关更多详细信息,请参阅 在你的 Space 中添加使用 HF 登录按钮

disable_embedding : boolean
Space iframe 是否可以嵌入到其他网站中。默认为 false,即 Spaces 可以 嵌入。

startup_duration_timeout: string
为你的 Space 设置自定义启动持续时间超时。这是你的 Space 在超时之前允许启动的最大时间,并且会被标记为不健康。默认为 30 分钟,但任何有效的持续时间(如 1h30m)都是可以接受的。

custom_headers : Dict[string, string]
设置自定义 HTTP 标头,这些标头将在提供你的 Space 时添加到所有 HTTP 响应中。
目前,只允许 跨域嵌入策略 (COEP)、跨域打开策略 (COOP) 和 跨域资源策略 (CORP) 标头。这些标头可用于设置跨域隔离环境,并启用强大的功能,例如 SharedArrayBuffer,例如

custom_headers:
  cross-origin-embedder-policy: require-corp
  cross-origin-opener-policy: same-origin
  cross-origin-resource-policy: cross-origin

注意:所有标头和值必须为小写。

preload_from_hub: List[string] 指定要在你 Space 的构建时间预加载的 Hugging Face Hub 模型或其他大型文件的列表。通过在你的应用程序启动时准备就绪的文件,这可以优化启动时间。这对于依赖于大型模型或数据集的 Spaces 尤其有用,否则这些模型或数据集需要在运行时下载。

每个项目的格式为 "repository_name",以下载来自存储库的所有文件,或 "repository_name file1,file2",以下载该存储库内的特定文件。你还可以使用格式 "repository_name file1,file2 commit_sha256" 指定要下载的特定提交。

示例用法

preload_from_hub:
  - warp-ai/wuerstchen-prior text_encoder/model.safetensors,prior/diffusion_pytorch_model.safetensors
  - coqui/XTTS-v1
  - openai-community/gpt2 config.json 11c5a3d5811f50298f278a704980280950aedb10

在此示例中,Space 将在构建时从 Hugging Face Hub 中预加载来自 warp-ai/wuerstchen-prior 的特定 .safetensors 文件、完整的 coqui/XTTS-v1 存储库以及来自 openai-community/gpt2 存储库的特定修订版的 config.json 文件。

文件保存在默认的 huggingface_hub 磁盘缓存 ~/.cache/huggingface/hub 中。如果你的应用程序期望它们位于其他位置或你更改了 HF_HOME 变量,则此预加载目前不会遵循该变量。
< > 在 GitHub 上更新