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仓库：

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配置：

---
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
• 模型权重
• Gradio文档
• HF Spaces文档