# MoneyPrinterTurbo Huggingface Spaces 部署指南

## 🎉 最新部署状态

✅ **部署成功！** 应用已在Huggingface Spaces上线  
🔗 **访问地址**: [MoneyPrinterTurbo on HF Spaces](https://huggingface.co/spaces/your-username/MoneyPrinterTurbo)

### 📋 部署完成清单
- [x] 创建Huggingface Space
- [x] 上传所有项目文件  
- [x] 配置启动文件 (app.py)
- [x] 设置依赖文件 (requirements.txt)
- [x] 优化FREE层级配置
- [x] 解决启动问题

---

## 🚀 快速部署步骤

### 1. 准备文件
确保以下文件已准备好：
- `app.py` - 简化的Streamlit启动文件
- `README.md` - 项目说明（从README_HF.md重命名）
- `requirements.txt` - 精简的依赖列表（从requirements_hf.txt重命名）
- `config.toml` - 预配置的设置文件

### 2. 创建Huggingface Space
1. 访问 https://huggingface.co/spaces
2. 点击 "Create new Space"
3. 选择 "Streamlit" 作为SDK
4. 设置Space名称和描述

### 3. 上传文件
将所有项目文件上传到新创建的Space，确保：
- `app.py` 作为主入口文件
- 所有必要的项目文件和目录结构完整

### 4. 配置环境变量（重要！）

在Space的Settings页面添加以下环境变量：

#### LLM服务商API密钥
```bash
DEEPSEEK_API_KEY=sk-xxxxxx          # DeepSeek API密钥
MOONSHOT_API_KEY=sk-xxxxxx          # Moonshot API密钥  
OPENAI_API_KEY=sk-xxxxxx            # OpenAI API密钥
```

#### 视频素材API密钥
```bash
PEXELS_API_KEY=xxxxxx               # Pexels视频素材
PIXABAY_API_KEY=xxxxxx              # Pixabay视频素材
```

#### 语音合成API密钥
```bash
AZURE_SPEECH_KEY=xxxxxx             # Azure语音服务密钥
AZURE_SPEECH_REGION=eastus          # Azure服务区域
```

#### 其他服务
```bash
SILICONFLOW_API_KEY=sk-xxxxxx       # SiliconFlow API密钥
MONEYPRINTER_API_KEY=xxxxxx         # MoneyPrinter官方API（可选）
```

---

## 🔧 问题解决方案

### ✅ 已解决的问题

1. **启动卡在"Starting"状态**
   - 原因：复杂的启动逻辑和subprocess调用
   - 解决：简化为直接Streamlit应用，移除subprocess启动

2. **依赖包安装失败**
   - 原因：包含不兼容的系统级依赖
   - 解决：使用精简的requirements_hf.txt

3. **资源超限问题**
   - 原因：FREE层级资源限制
   - 解决：优化配置，限制并发任务数

### 🛠️ 当前功能状态

- ✅ **基础界面**: 应用启动和配置检查
- ✅ **环境变量加载**: 自动读取HF Spaces环境变量
- ✅ **API密钥验证**: 显示已配置的服务状态
- 🔄 **视频生成**: 核心功能适配中
- 🔄 **完整界面**: 原Main.py功能迁移中

---

## 📊 API密钥获取指南

### DeepSeek API (推荐)
1. 访问 https://platform.deepseek.com/
2. 注册账户并获取API密钥
3. 新用户通常有免费额度

### Moonshot API  
1. 访问 https://platform.moonshot.cn/
2. 注册并获取API密钥
3. 性价比较高的国产LLM

### Pexels API (视频素材)
1. 访问 https://www.pexels.com/api/
2. 免费注册获取API密钥
3. 每月有免费请求限额

### Azure Speech (语音合成)
1. 访问 https://azure.microsoft.com/services/cognitive-services/speech-services/
2. 创建Azure账户和Speech资源
3. 获取API密钥和区域信息

---

## 🎯 使用建议

### FREE层级最佳实践
1. **视频时长**: 建议30-60秒
2. **并发限制**: 同时只生成1个视频
3. **素材选择**: 优先使用缓存的素材
4. **API调用**: 合理控制频率

### 性能优化
- 使用简化界面减少资源占用
- 启用素材缓存机制
- 限制同时处理的任务数量

---

## 📞 技术支持

如遇到问题，请检查：
1. **Space日志**: 查看启动和运行日志
2. **环境变量**: 确认API密钥配置正确
3. **网络连接**: 确保API服务可访问
4. **资源限制**: 监控内存和CPU使用

---

## 🔄 后续计划

1. **完整功能迁移**: 逐步适配所有视频生成功能
2. **性能优化**: 进一步优化FREE层级体验
3. **用户界面**: 改进交互体验
4. **文档完善**: 添加更多使用教程

---

*最后更新: 2024年*