| # 快速部署到 Hugging Face Spaces | |
| ## 🚀 一键部署步骤 | |
| ### 1. 获取完整源代码 | |
| 由于这个文件夹只包含配置文件，你需要先获取完整的 grok2api 源代码： | |
| ```bash | |
| # 克隆原项目 | |
| git clone https://github.com/chenyme/grok2api.git temp_grok2api | |
| # 复制 app 目录到当前文件夹 | |
| cp -r temp_grok2api/app ./ | |
| # 清理临时文件 | |
| rm -rf temp_grok2api | |
| ``` | |
| ### 2. 创建 Hugging Face Space | |
| 1. 访问：https://huggingface.co/new-space | |
| 2. 填写信息： | |
| - Space name: `grok2api`（或自定义） | |
| - License: MIT | |
| - SDK: **Docker** | |
| - Hardware: CPU basic（免费） | |
| 3. 创建完成后，获取 Space 的 Git 仓库地址 | |
| ### 3. 推送代码 | |
| ```bash | |
| # 初始化 git（如果还没有） | |
| git init | |
| # 添加所有文件 | |
| git add . | |
| # 提交 | |
| git commit -m "Initial Hugging Face Spaces deployment" | |
| # 添加远程仓库（替换为你的 Space URL） | |
| git remote add hf https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME | |
| # 推送 | |
| git push hf main | |
| ``` | |
| ### 4. 配置环境变量 | |
| 在 Space Settings 中添加（必需）： | |
| ```bash | |
| APP_KEY=your_password_here | |
| API_KEY=sk-your-api-key-here | |
| APP_URL=https://YOUR_USERNAME-YOUR_SPACE_NAME.hf.space | |
| DATA_DIR=/data | |
| ACCOUNT_STORAGE=local | |
| ``` | |
| ### 5. 启用 Persistent Storage | |
| ⚠️ **非常重要！** 在 Space Settings 中启用 Persistent Storage | |
| ### 6. 等待构建完成 | |
| 首次构建需要 5-10 分钟，可以在 "Logs" 标签查看进度 | |
| ### 7. 配置保活（推荐） | |
| Fork https://github.com/wankuzidi/hf-keepalive 并配置你的 Space URL | |
| --- | |
| 详细说明请查看 [DEPLOY_GUIDE.md](./DEPLOY_GUIDE.md) | |