README.md

metadata

title: Bloom Ware
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860

🌱 Bloom Ware on HuggingFace Spaces

Bloom Ware 由 銘傳大學 人工智慧應用學系「槓上開發」 團隊打造並維護，現在搬到 HuggingFace Spaces 給大家試玩。這份 README 也是 Space 的設定檔，記得留著。

✨ 你會看到什麼

• ⚙️ 後端採 FastAPI，入口統一在 app.py。
• 🧠 內建 Firebase、語音登入、MCP Agent 橋接等服務，冷啟即用。
• 💤 免費計算資源有限，背景排程預設關閉，必要時自己開。

🚀 快速部署步驟

1. 建好 Space 後會自動 pip install -r requirements.txt，不用動。
2. 別覆蓋 PORT，HuggingFace 會給 PORT=7860，服務會自動抓。
3. 到 Settings → Secrets 補齊所有敏感環境變數，另外加上
   • ENABLE_BACKGROUND_JOBS=false（免費機器就別硬跑排程）
   • 任何金鑰、密碼、Firebase JSON 都放 Secrets，不要 commit。

🧪 本地或 Space 驗證

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
ENABLE_BACKGROUND_JOBS=false PORT=7860 python app.py

走 http://127.0.0.1:7860 看畫面是否正常，再 decide 要不要推到 Space。

📦 推上 HuggingFace

（已移除 HuggingFace/SpeechBrain 相依，無需設定 token）
cd Bloom_Ware
# 將最新程式碼覆蓋進來
git add .
git commit -m "同步 Bloom Ware 最新變更"
git push
# 出現 password 提示時，貼上剛剛的 access token

🧠 設定小抄

• ENABLE_BACKGROUND_JOBS：在 HuggingFace 建議設 false，避免快取維護、批次任務、清理排程耗掉寶貴 CPU；若搬回 Render 或其他長駐環境，再調回 true。
• 其他 Render 時期的環境變數照舊，沒有特別兼容性的 hack。
• OPENROUTESERVICE_API_KEY：啟用路徑規劃工具（OpenRouteService）。

🤝 團隊資訊

我們是銘傳大學人工智慧應用學系的 槓上開發，專注把 AI 工具塞進實際應用。如果覺得好用，請幫 Space 點顆 ⭐️，或開 Issue/PR 跟我們互嗆（友善互動）。歡迎合作 🙌