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方式 (推荐)

# 克隆你的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开头有以下配置：

---
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文档