# 快速部署到 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)