2025年6月26日 星期四

如何在 Hugging Face Spaces 平台佈署 Gradio 網頁應用程式

Hugging Face Spaces 是AI 開源平台 Hugging Face 提供的免費雲端 Python Web app 主機服務 (也有提供收費方案), 我曾經在測試 Gradio 時紀錄佈署的方法, 參考 :


不過目前網頁似乎有些小更動, 所以下面以昨天用 Gradio 寫的 OpenAI Image API 測試程式為例, 重新寫一篇說明如何將 web app 佈署到 Hugging Face Spaces 平台上. 

首先須註冊 Hugging Face 帳號 : 


登入後點選右上角的 "Spaces" 超連結 : 




按右上角 "+ New Space" 按鈕 : 




填寫 Space Name 與 Description 欄位, 勾選授權方式, 點選 Gradio SDK 後按左下角的 "Create Space" 鈕建立託管空間 :





完成後會自動進入此空間之頁面, 按右上角的三個小點按鈕, 點選彈出選單中的 File 進入檔案管理頁面 : 




按右方的 "+Contribute" 按鈕, 點選彈出選單中的 "Create a new file" : 




在空間名稱後面的文字框輸入 app.py, 這是 web app space 執行時預設會去尋找的主程式名稱 (可以用其他名稱, 但必須先在 README.md 或 .huggingface.yml 指定 app_file 主程式檔名), 然後將 web app 程式貼在下方程式輸入區, 然後按左下方的 "Commit new file to main" 鈕即可 :





這樣便新增了主程式 app.py, 按上方 Spaces 後面的空間名稱即可執行 web app; 按下方 main 後面的專案名稱則會顯示此空間內的檔案列表 : 




但這個 App 有用到平台未預先安裝的套件 openai, 所以直接執行會出現錯誤, 按右上角的三個小點按鈕點選 Files, 這樣也會顯示檔案列表 : 




然後重複上面新增 app.py 的做法, 按右方的 "+Contribute" 按鈕, 點選彈出選單中的 "Create a new file", 在上面檔案名稱文字框輸入 requirements.txt, 在下方 Edit 文字框輸入 openai,  按左下方的 "Commit new file to main" 鈕即可建立此套件安裝檔 : 





這時按 Spaces 後面的空間名稱就可以順利執行此 web app 了 :





這樣便完成 web app 的佈署了 : 


全部 app 列表參考 :


沒有留言 :