# Hugging Face Space 部署指南

## 📋 准备工作

确保您已经有以下文件：
- `app.py` - 主要的 Gradio 应用
- `requirements.txt` - Python 依赖
- `README.md` - 项目说明文档  
- `.gitignore` - Git 忽略文件
- `README.md.space` - Hugging Face Space 配置（需要重命名为 README.md）

## 🚀 部署步骤

### 1. 创建 Hugging Face Space

1. 登录 [Hugging Face](https://huggingface.co/)
2. 点击您的头像 → "New Space"
3. 填写 Space 信息：
   - **Space name**: `GENIE` （或其他您喜欢的名称）
   - **License**: MIT
   - **SDK**: Gradio
   - **Hardware**: CPU (免费) 或 GPU (付费)
   - **Visibility**: Public

### 2. 上传文件

有两种方式上传文件：

#### 方式 A: Git 上传（推荐）
```bash
# 1. 克隆您创建的 Space
git clone https://huggingface.co/spaces/YOUR_USERNAME/GENIE
cd GENIE

# 2. 复制所有文件到此目录
# 将 README.md.space 重命名为 README.md（会替换默认的）

# 3. 提交并推送
git add .
git commit -m "Initial Genie TTS deployment"
git push
```

#### 方式 B: Web 界面上传
1. 在 Space 页面点击 "Files" 标签
2. 点击 "Add file" → "Upload file"
3. 上传所有必要文件
4. 将 `README.md.space` 的内容复制到默认的 `README.md` 中

### 3. 配置 Space

确保 README.md 文件开头包含正确的 YAML 元数据：

```yaml
---
title: 🔮 Genie TTS - AI语音合成
emoji: 🎵
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
short_description: 基于Genie的日语文本转语音系统
tags:
  - text-to-speech
  - japanese
  - gpt-sovits
  - audio
  - ai
  - tts
  - voice-synthesis
---
```

### 4. 等待构建

- Space 将自动开始构建
- 首次构建可能需要 5-10 分钟
- 您可以在 "Logs" 标签中查看构建进度

### 5. 测试应用

1. 构建完成后，访问您的 Space
2. 测试基本功能：
   - 选择角色 "misono_mika"
   - 输入日语文本，例如："おはようございます"
   - 点击 "开始合成"
   - 等待音频生成

## ⚠️ 注意事项

### 性能考虑
- **首次运行**: 需要下载约 200MB 的模型文件，可能需要 30-60 秒
- **后续使用**: 模型会被缓存，合成速度较快（5-15 秒）
- **并发限制**: 免费 CPU 硬件建议限制并发用户数

### 内存管理
- Genie TTS 需要约 500MB-1GB RAM
- 如果遇到内存不足错误，考虑升级到付费硬件

### 错误排查

1. **依赖安装错误**
   - 检查 `requirements.txt` 中的版本冲突
   - 查看构建日志中的错误信息

2. **模型下载失败**
   - 通常是网络问题，等待几分钟后重试
   - 检查 Hugging Face Hub 的连接状态

3. **音频生成失败**
   - 检查输入文本是否为日语
   - 验证文本长度不超过 500 字符

## 🔧 高级配置

### 自定义硬件
如果需要更好的性能，可以升级硬件：
- **CPU Upgrade**: 更快的处理速度
- **GPU T4**: 显著提升推理速度（需要付费）

### 环境变量
在 Space 设置中添加环境变量：
```
HF_HUB_ENABLE_PROGRESS_BAR=1
TOKENIZERS_PARALLELISM=false
```

### 域名和访问
- Space URL: `https://huggingface.co/spaces/YOUR_USERNAME/GENIE`
- 可以申请自定义域名（Pro 功能）

## 📊 监控和维护

- 查看 Space 使用统计
- 监控错误日志
- 定期更新依赖包
- 根据用户反馈优化功能

## 🤝 社区分享

部署成功后，您可以：
- 在社交媒体分享您的 Space
- 在相关社区发布
- 收集用户反馈并持续改进

---

祝您部署成功！如有问题，可以参考 [Hugging Face Spaces 官方文档](https://huggingface.co/docs/hub/spaces)。