QUICKSTART.md

快速部署到 Hugging Face Spaces

🚀 一键部署步骤

1. 获取完整源代码

由于这个文件夹只包含配置文件，你需要先获取完整的 grok2api 源代码：

# 克隆原项目
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. 推送代码

# 初始化 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 中添加（必需）：

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