| # 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)。 |
