DEPLOYMENT.md

# 🚀 Hugging Face Space 部署指南

## 📁 文件结构

确保你的HF Space包含以下文件：

```
Acfoley/
├── README.md          # Space配置和说明
├── app.py            # 主应用文件
├── requirements.txt  # Python依赖
├── packages.txt      # 系统依赖
├── hf_AC/           # hf_AC模型代码
└── .gitignore       # Git忽略文件
```

## 🔧 部署步骤

### 1. 上传代码到HF Space

将所有文件上传到你的Hugging Face Space仓库：

```bash
git add .
git commit -m "Add hf_AC audio generation demo"
git push
```

### 2. 模型权重下载

模型会自动从以下位置下载：
- 主模型: `https://huggingface.co/FF2416/AC-Foley/resolve/main/model.pth`
- 其他组件会根据需要自动下载

### 3. 环境配置

HF Space会自动：
- 安装`requirements.txt`中的Python包
- 安装`packages.txt`中的系统依赖
- 运行`app.py`启动Gradio界面

## 📋 README.md 配置

确保README.md顶部包含正确的YAML配置：

```yaml
---
title: hf_AC Audio Foley Generator
emoji: 🎵
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
pinned: false
license: mit
---
```

## 🔍 故障排除

### 常见问题

1. **模型下载失败**
   - 检查网络连接
   - 确认模型URL可访问

2. **依赖安装失败**
   - 检查`requirements.txt`格式
   - 确认包版本兼容性

3. **内存不足**
   - HF Space免费版有内存限制
   - 考虑优化模型或升级到付费版

### 调试方法

1. 查看Space日志
2. 运行`test_setup.py`验证环境
3. 检查模型文件是否正确下载

## 🎯 使用说明

部署成功后，用户可以：

1. 上传MP4视频文件
2. 输入音频描述文字
3. 调整生成参数
4. 点击生成按钮
5. 下载生成的音频

## 📊 性能优化

- 首次运行需要下载模型（约几GB）
- 生成时间取决于视频长度和硬件
- 建议视频时长控制在15秒以内

## 🔗 相关链接

- [hf_AC GitHub](https://github.com/ff2416/hf_AC)
- [模型权重](https://huggingface.co/FF2416/AC-Foley)
- [Gradio文档](https://gradio.app/docs/)
- [HF Spaces文档](https://huggingface.co/docs/hub/spaces)