DEPLOY_GUIDE.md

# 🚀 DreamRenderer 部署指南

## 当前状态

✅ 所有文件已准备就绪
✅ 测试已通过
✅ 准备部署到 Hugging Face Spaces

## 部署步骤

### 1. 创建 Hugging Face Space

1. 访问: <https://huggingface.co/spaces>
2. 点击 "Create new Space"
3. 配置如下：

   ```
   Space name: dreamrenderer (或你的选择)
   License: apache-2.0
   SDK: Gradio
   Hardware: ZeroGPU ⚠️ 这是关键！
   ```

### 2. 上传文件

按以下顺序上传文件到你的Space：

1. **README.md** - Space配置文件
2. **requirements.txt** - 依赖列表
3. **app.py** - 主应用文件
4. **dream_renderer.py** - 核心实现
5. **bbox_component.html** - UI组件

### 3. 文件上传方式

**方法A: 网页界面上传**

- 在Space页面点击 "Files" 标签
- 拖拽文件到上传区域
- 每个文件上传后都会触发重新构建

**方法B: Git方式 (推荐)**

```bash
# 克隆你的Space仓库
git clone https://huggingface.co/spaces/YOUR_USERNAME/dreamrenderer
cd dreamrenderer

# 复制文件
cp /data0/lmw/zerogpu/README.md .
cp /data0/lmw/zerogpu/requirements.txt .
cp /data0/lmw/zerogpu/app.py .
cp /data0/lmw/zerogpu/dream_renderer.py .
cp /data0/lmw/zerogpu/bbox_component.html .

# 提交并推送
git add .
git commit -m "Initial DreamRenderer implementation"
git push
```

### 4. 检查配置

确保README.md开头有以下配置：

```yaml
---
title: DreamRenderer
emoji: 🎨
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: apache-2.0
---
```

### 5. ZeroGPU 重要说明

⚠️ **关键点**：

- 必须在Space设置中选择 `ZeroGPU` 硬件
- 代码中已正确使用 `@spaces.GPU` 装饰器
- ZeroGPU 提供免费的GPU加速，但有使用限制

### 6. 部署后验证

部署完成后：

1. 等待Space构建完成（通常2-5分钟）
2. 检查Space是否显示 "Running on ZeroGPU"
3. 测试边界框绘制功能
4. 测试图像生成功能

### 7. 常见问题

**问题1**: Space构建失败

- 解决方案: 检查requirements.txt中的包版本

**问题2**: 没有使用ZeroGPU

- 解决方案: 在Space设置中重新选择ZeroGPU硬件

**问题3**: 边界框组件不显示

- 解决方案: 确保bbox_component.html文件已正确上传

## 🎯 下一步

部署成功后，你可以：

1. 集成真实的DreamRenderer模型权重
2. 添加更多示例和预设
3. 优化UI和用户体验
4. 分享你的Space！

## 📞 获取帮助

如果遇到问题：

1. 检查Space的日志输出
2. 确认所有文件都已上传
3. 验证ZeroGPU配置
4. 查看Hugging Face Spaces文档