| title: Hfbase API | |
| emoji: 🚀 | |
| colorFrom: blue | |
| colorTo: green | |
| sdk: docker | |
| app_port: 7860 | |
| pinned: false | |
| # HFBase API | |
| 基于 Node.js 20 LTS + Python 3.12 的 FastAPI 服务，部署在 HuggingFace Spaces。 | |
| ## 技术栈 | |
| - **Node.js**: 20 LTS (多阶段构建) | |
| - **Python**: 3.12 (运行时) | |
| - **Web 框架**: FastAPI + Uvicorn | |
| - **生产服务器**: Gunicorn + UvicornWorker | |
| - **部署平台**: HuggingFace Spaces (Docker SDK) | |
| ## API 端点 | |
| - `GET /` - 欢迎信息 | |
| - `GET /health` - 健康检查 | |
| - `GET /info` - 系统信息 | |
| - `GET /docs` - FastAPI 自动文档 | |
| ## 部署信息 | |
| 此项目配置为在 HuggingFace Spaces 上运行，使用 Docker SDK 和端口 7860。 | |
| ### 构建和部署 | |
| ```bash | |
| # 本地测试 | |
| docker build -t hfbase-api . | |
| docker run -p 7860:7860 hfbase-api | |
| # 访问 API | |
| curl http://localhost:7860/health | |
| ``` | |
| ## 配置参考 | |
| 详细配置参考: [HuggingFace Spaces 配置文档](https://huggingface.co/docs/hub/spaces-config-reference) | |