Hub 文件
靜態 HTML Spaces
單一登入 (SSO) 稽核記錄 儲存區域 私人資料集資料工作室 (Data Studio) 資源群組(存取控制) 進階運算選項 進階安全性 Token 管理 發布者分析 門控群組集合 (Gating Group Collections) 網路安全 速率限制 部落格文章
PRO 方案 儲存庫 (Repositories) 儲存庫入門 儲存庫設定 儲存空間限制 儲存後端 (Xet) 本地快取 合併請求 (Pull Requests) 與討論 通知 選集 (Collections) Webhooks GitHub Actions 筆記本 後續步驟 授權協議
模型 (Models) 模型中心 (Model Hub) 模型卡片 評估結果 排行榜資料 門控模型 (Gated Models) 上傳模型 下載模型 整合函式庫 模型小工具 (Model Widgets) 模型推論 模型下載統計 模型發布檢查清單 本地應用程式 常見問題集 進階主題
資料集 (Datasets) 資料集概覽 資料集卡 (Dataset Cards) 門控資料集 (Gated Datasets) 上傳資料集 上傳資料集(針對 LLM) 下載資料集 串流資料集 整合函式庫 資料工作室 (Data Studio) 代理追蹤 (Agent Traces) 資料集下載統計
Spaces Spaces 概覽 Spaces GPU 升級 Spaces ZeroGPU Spaces 開發模式 Spaces 磁碟使用量與儲存空間 Spaces 自訂網域 將 Spaces 作為 MCP 伺服器 將 Spaces 作為代理工具 (Agent Tools) 將 Spaces 作為 API 端點 Gradio Spaces Streamlit Spaces 靜態 HTML Spaces Docker Spaces 嵌入您的 Space 使用 Docker 執行 Spaces Spaces 設定參考 使用 HF 按鈕登入 精選 Spaces Spaces 更新日誌 進階主題
儲存桶 全新 Jobs Agent 代理 (Agents) 概覽 適用於 AI 代理的 Hugging Face CLI Hugging Face MCP 伺服器 Hugging Face 代理技能 使用 HF SDK 建構代理 使用 llama.cpp 建立本地代理 代理函式庫
其他 加入 Hugging Face 社群
並獲得增強的文件體驗
開始使用
靜態 HTML Spaces
除了使用 Streamlit 或 Gradio,Spaces 也支援為您的應用程式提供自訂 HTML。請在 Spaces README.md 檔案頂部的 YAML 區塊中設定 sdk: static。接著,您就可以將 HTML 程式碼放置於 index.html 檔案中。
以下是一些使用自訂 HTML 的 Spaces 範例:
- Smarter NPC:在 Spaces 中透過 iframe 顯示 PlayCanvas 專案。
- Huggingfab:在 Spaces 中顯示 Sketchfab 模型。
- Diffuse the rest:繪圖並進行擴散運算(Diffuse the rest)。
在服務前增加建置步驟
靜態 Spaces 支援在服務靜態資源前增加自訂建置步驟。這對於像 React、Svelte 和 Vue 這類需要在服務應用程式前進行建置程序的前端框架非常有用。當您的 Space 更新時,建置指令會自動執行。
請在 Spaces README.md 檔案頂部的 YAML 區塊中加入 app_build_command,以及 app_file。
例如:
app_build_command: npm run buildapp_file: dist/index.html
範例 Spaces
在底層,它會啟動一個建置程序,並將產生的檔案儲存在特殊的 refs/convert/build 參照中。
Space 變數
自訂的環境變數可以傳遞給您的 Space。如果您已為 Space 啟用 OAuth,OAuth 相關資訊(例如客戶端 ID 與範圍)也會以環境變數的形式提供。
若要在 JavaScript 中使用這些變數,您可以使用 window.huggingface.variables 物件。例如,若要存取 OAUTH_CLIENT_ID 變數,可以使用 window.huggingface.variables.OAUTH_CLIENT_ID。
這是一個使用自訂環境變數並啟用 OAuth,且在 HTML 中顯示變數的 Space 範例:
在 GitHub 上更新