DEPLOY.md

部署 HuggingRun 到 Hugging Face Spaces

1. 创建 Space

在 huggingface.co/new-space 新建 Space：

• SDK: 选 Docker
• Space name: 例如 HuggingRun
• 创建后得到 https://huggingface.co/spaces/<你的用户名>/HuggingRun

2. 推送代码

在本地项目目录执行（把 tao-shen 换成你的 HF 用户名）：

cd /Users/tao.shen/HuggingRun
git remote remove origin 2>/dev/null || true
git remote add origin https://huggingface.co/spaces/<你的用户名>/HuggingRun
git push -u origin main

若 HF 需要认证，先执行：

pip install -q huggingface_hub && huggingface-cli login

或使用 Git 凭证（HF 支持 Personal Access Token 作为密码）。

3. 本地验证（可选）

确保 Docker 已启动后：

docker build -t huggingrun:local .
docker run --rm -p 7860:7860 -e PORT=7860 huggingrun:local

浏览器打开 http://localhost:7860 应看到默认 demo（访问计数）。Ctrl+C 停止。

4. 难例测试（FastAPI + SQLite）

在 Space 的 Settings → Repository secrets 中增加：

• RUN_CMD = uvicorn app.fastapi_sqlite:app --host 0.0.0.0 --port 7860
• （可选）HF_TOKEN、AUTO_CREATE_DATASET = true 以开启持久化

保存后 Space 会重新构建。打开 App 查看首页和 /api，重启 Space 后访问次数应保持（若已配 HF 持久化）。

完成标准

• Space 创建并推送代码成功
• 默认 demo 在 Space 中可访问（7860）
• 设置 RUN_CMD 后 FastAPI+SQLite 难例可访问且（可选）重启后数据仍在