huggingface-gradio 是什麼、怎麼安裝使用：讓智能體用 Gradio 搭 AI 演示介面的官方 Skill

本文根據 huggingface/skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 huggingface/skills 在 GitHub 約 1.1 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

Gradio 是 Python 裏最常用的 AI 演示介面庫：幾行代碼就能給模型套上一個可以在瀏覽器裏操作的頁面，Hugging Face Spaces 上的大量演示都是用它做的。它的大版本之間 API 變化不小，模型很容易把舊版本的參數和新版本的寫法混在一起。huggingface-gradio 是一份對着當前版本寫的參考。description：用 Python 構建 Gradio 網頁介面和演示；在創建或編輯 Gradio 應用、組件、事件監聽器、佈局或聊天機器人時使用。

SKILL.md 的結構像一份濃縮的官方文檔：

• 指南連結：快速上手、Interface 類、Blocks 與事件監聽、佈局控制等官方指南的地址，相關時去讀；
• 核心模式：幾種最常見的應用骨架；
• 關鍵組件簽名：Textbox、Number、Slider、Checkbox、Dropdown、Radio、Image、Audio、Video、File、Chatbot、Button、Markdown、HTML 等組件的構造參數；
• 自定義 HTML 組件、事件監聽器；
• 預測命令行：從終端調用 Gradio 應用的接口。

目錄裏另有一份 examples.md，收了一批可直接參照的示例。

怎麼安裝

按倉庫 README，Claude Code 先登記市場並安裝基礎的 CLI 技能，其餘技能再用 hf 命令行添加：

text
/plugin marketplace add huggingface/skills
/plugin install hf-cli@huggingface/skills

bash
hf skills add huggingface-gradio

Codex 的做法是把倉庫 skills/ 下需要的文件夾複製或軟連結到 .agents/skills；Gemini CLI 用 gemini extensions install https://github.com/huggingface/skills.git --consent。

倉庫整體介紹和其他安裝方式，詳見本站《huggingface/skills 是什麼、怎麼安裝：Hugging Face 官方 Agent Skills（hf-cli、模型訓練、數據集、Spaces、Gradio）》。

怎麼用

• 「給這個圖像分類函數做一個 Gradio 介面：上載圖片，返回前三個類別和置信度」。
• 「做一個流式輸出的聊天介面，後端調用我已有的 generate() 函數」。
• 「把這個頁面改成左右兩欄佈局，左邊放參數，右邊放結果」。

適合誰 / 侷限

適合需要快速給模型或數據處理腳本配一個可操作介面的算法工程師、研究者和學生，尤其是打算把演示發佈到 Spaces 的人。Gradio 擅長演示和內部工具，不適合做面向大量用戶的正式產品前端；技能內容跟隨它生成時的 Gradio 版本，你的項目版本較舊時要告訴智能體。

注意事項

• 許可：Apache-2.0。
• 不執行腳本；參考官方指南時會聯網。
• 公開分享要小心：Gradio 的分享連結和公開的 Space 任何人都能訪問，演示背後如果調用了付費 API 或能讀本地文件，記得加訪問控制和限流。
• 部署到 Spaces 的配置（硬件、密鑰）見該庫的 Spaces 相關技能。