Upload 6 files

DEPLOYMENT_CHECKLIST.md

@@ -0,0 +1,112 @@
+# Huggingface Spaces 部署检查清单
+
+## 📋 必须上传的文件清单
+
+### ✅ 核心文件
+- [x] `app.py` - HF Spaces入口文件
+- [x] `README.md` - 带有正确YAML头的项目说明
+- [x] `requirements.txt` - Python依赖
+- [x] `packages.txt` - 系统依赖
+- [x] `config.toml` - 配置文件
+
+### ✅ 应用代码
+- [x] `app/` - 完整应用目录
+- [x] `webui/` - Streamlit界面
+- [x] `resource/` - 字体和音乐资源
+
+### ✅ 文档文件
+- [x] `API_GUIDE.md` - API使用指南
+- [x] `DEPLOYMENT_HF.md` - 部署指南
+- [x] `.gitignore` - Git忽略文件
+
+## 🚫 不需要上传的文件
+
+### ❌ 开发文件
+- [ ] `Dockerfile` - HF不使用Docker构建
+- [ ] `.dockerignore` - HF不需要
+- [ ] `docker-compose.yml` - 本地开发用
+- [ ] `main.py` - 本地启动脚本
+- [ ] `webui.bat` / `webui.sh` - 本地脚本
+- [ ] `start_hf.sh` - 已集成到app.py
+
+### ❌ 示例和测试文件
+- [ ] `config.example.toml` - 示例配置
+- [ ] `test/` - 测试目录
+- [ ] `docs/` - 文档图片
+
+## 🔧 构建卡住的常见原因及解决方案
+
+### 1. 缺少YAML头部
+**问题**: README.md没有正确的YAML配置
+**解决**: 确保README.md开头有完整的YAML头部
+
+### 2. 依赖版本冲突
+**问题**: requirements.txt中的包版本不兼容
+**解决**: 使用优化后的requirements.txt（已修复）
+
+### 3. 系统依赖缺失
+**问题**: 缺少ffmpeg等系统依赖
+**解决**: 创建packages.txt文件（已创建）
+
+### 4. 启动脚本问题
+**问题**: app.py启动逻辑有误
+**解决**: 使用优化后的app.py（已修复）
+
+### 5. 配置文件问题
+**问题**: config.toml格式错误
+**解决**: 检查TOML语法，确保没有语法错误
+
+## 🔍 部署后故障排除
+
+### 检查构建日志
+1. 在HF Spaces界面查看"Logs"标签
+2. 寻找错误信息，通常出现在：
+   - 依赖安装阶段
+   - 应用启动阶段
+
+### 常见错误及解决方案
+
+#### 错误: "No module named 'xxx'"
+```bash
+解决: 在requirements.txt中添加缺失的包
+```
+
+#### 错误: "Address already in use"
+```bash
+解决: 检查app.py中的端口配置是否为7860
+```
+
+#### 错误: "Permission denied"
+```bash
+解决: 检查文件权限，确保app.py有执行权限
+```
+
+#### 错误: "ffmpeg not found"
+```bash
+解决: 确保packages.txt包含ffmpeg
+```
+
+## 🚀 优化建议
+
+### 性能优化
+- 限制最大并发任务数为1
+- 使用轻量级依赖版本
+- 启用资源限制保护
+
+### 安全优化
+- 配置环境变量保护API密钥
+- 启用API访问控制
+- 移除调试日志中的敏感信息
+
+### 用户体验优化
+- 提供清晰的配置指引
+- 添加错误处理和用户友好的错误消息
+- 支持多语言界面
+
+## 📞 支持信息
+
+如果部署仍然失败，请检查：
+1. HF Spaces配额是否足够
+2. 是否选择了正确的SDK (Streamlit)
+3. 文件是否完整上传
+4. YAML配置是否正确

README.md

@@ -1,6 +1,6 @@
 ---
 title: MoneyPrinterTurbo
-emoji: 💸
+emoji: 🎬
 colorFrom: blue
 colorTo: purple
 sdk: streamlit
@@ -10,35 +10,58 @@ pinned: false
 license: mit
 ---
 
-# MoneyPrinterTurbo 💸
+# MoneyPrinterTurbo 🎬
 
-只需提供一个视频主题或关键词，就可以全自动生成视频文案、视频素材、视频字幕、视频背景音乐，然后合成一个高清的短视频。
+AI驱动的短视频自动生成工具，支持自动文案生成、语音合成、视频剪辑等功能。
 
-## 特性
+## 功能特点
 
-- 🎯 完整的MVC架构，代码结构清晰
-- 🤖 支持视频文案AI自动生成
-- 📱 支持多种高清视频尺寸（竖屏9:16，横屏16:9）
-- 🎵 支持多种语音合成和背景音乐
-- 📝 支持字幕生成和自定义样式
-- 🌍 支持中文和英文视频文案
-- 🔗 支持多种AI模型接入（OpenAI、Moonshot、DeepSeek等）
+- 🤖 **AI文案生成**: 支持OpenAI、DeepSeek、Moonshot等多种LLM
+- 🎵 **智能语音合成**: Azure TTS、Edge TTS等多种语音服务
+- 🎥 **自动视频剪辑**: 从Pexels、Pixabay获取素材并智能剪辑
+- 📝 **字幕生成**: 自动生成和同步字幕
+- 🔄 **API支持**: 完整的RESTful API接口
+
+## 快速开始
+
+### 配置API密钥
+
+在使用前，请在WebUI的"基础设置"中配置以下API密钥：
+
+#### 必需配置
+- **LLM提供商**: DeepSeek/Moonshot/OpenAI (至少选择一个)
+- **视频素材源**: Pexels/Pixabay (至少选择一个)
+
+#### 可选配置
+- **Azure Speech**: 高质量语音合成
+- **SiliconFlow**: 备用语音服务
+
+### API密钥获取
+- DeepSeek: https://platform.deepseek.com/api_keys (推荐，国内可访问)
+- Moonshot: https://platform.moonshot.cn/console/api-keys (推荐，国内可访问)
+- Pexels: https://www.pexels.com/api/ (免费，高质量素材)
 
 ## 使用说明
 
-1. 在左侧面板配置LLM提供商和API密钥
-2. 配置视频素材来源API密钥（Pexels或Pixabay）
-3. 输入视频主题或直接编写视频文案
-4. 选择视频设置（尺寸、时长、音频等）
-5. 点击"生成视频"按钮开始制作
+1. 在左侧配置面板中设置API密钥
+2. 在主界面输入视频主题
+3. 调整视频参数（时长、比例、语音等）
+4. 点击"开始生成"等待视频制作完成
+
+## API调用
+
+本应用提供完整的API接口，支持外部系统调用。详细文档请参考项目中的 `API_GUIDE.md`。
 
 ## 注意事项
 
-- 由于Huggingface Spaces资源限制，建议生成较短的视频
-- 首次运行可能需要下载模型文件，请耐心等待
-- 建议使用DeepSeek或Moonshot作为LLM提供商（国内可直接访问）
+- 首次使用需要下载模型文件，请耐心等待
+- 建议生成较短的视频以节省资源
+- 如遇到网络问题，请检查API密钥配置
 
-## 相关链接
+## 技术栈
 
-- [GitHub仓库](https://github.com/harry0703/MoneyPrinterTurbo)
-- [使用文档](https://github.com/harry0703/MoneyPrinterTurbo/blob/main/README.md)
+- **前端**: Streamlit
+- **后端**: FastAPI
+- **AI**: OpenAI、DeepSeek、Moonshot
+- **视频处理**: MoviePy
+- **语音合成**: Azure TTS、Edge TTS

app.py

@@ -5,6 +5,7 @@ Huggingface Spaces entry point for MoneyPrinterTurbo
 import os
 import sys
 import subprocess
+import time
 
 # Add the root directory to Python path
 root_dir = os.path.dirname(os.path.abspath(__file__))
@@ -12,6 +13,7 @@ sys.path.insert(0, root_dir)
 
 def setup_environment():
     """Setup environment for Huggingface Spaces"""
+    print("📁 Creating storage directories...")
     # Create necessary directories
     os.makedirs(os.path.join(root_dir, "storage", "tasks"), exist_ok=True)
     os.makedirs(os.path.join(root_dir, "storage", "cache_videos"), exist_ok=True)
@@ -23,6 +25,7 @@ def setup_environment():
     os.environ["STREAMLIT_BROWSER_GATHER_USAGE_STATS"] = "false"
     os.environ["STREAMLIT_SERVER_ENABLE_CORS"] = "true"
     
+    print("🔧 Setting up configuration...")
     # Load API keys from environment variables if available
     setup_api_keys_from_env()
 
@@ -84,27 +87,57 @@ def setup_api_keys_from_env():
             print(f"✅ API keys configured: {len(keys_loaded)} service(s)")
         else:
             print("📝 No API keys found in environment variables")
+            print("💡 You can configure them in the WebUI after startup")
             
         config.save_config()
         
     except Exception as e:
-        print("⚠️ Warning: Could not load API keys from environment")
+        print(f"⚠️ Warning: Could not load API keys from environment: {e}")
+
+def check_system_dependencies():
+    """Check if required system dependencies are available"""
+    print("🔍 Checking system dependencies...")
+    
+    # Check for ffmpeg
+    try:
+        subprocess.run(["ffmpeg", "-version"], capture_output=True, check=True)
+        print("✅ FFmpeg is available")
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        print("⚠️ FFmpeg not found - video processing may fail")
+    
+    # Check Python version
+    if sys.version_info >= (3, 8):
+        print(f"✅ Python {sys.version_info.major}.{sys.version_info.minor} is compatible")
+    else:
+        print(f"⚠️ Python {sys.version_info.major}.{sys.version_info.minor} may have compatibility issues")
 
 def start_streamlit():
-    """Start Streamlit app"""
-    cmd = [
+    """Start Streamlit app with proper error handling"""
+    print("🚀 Starting Streamlit application...")
+    
+    streamlit_cmd = [
         sys.executable, "-m", "streamlit", "run", 
         os.path.join(root_dir, "webui", "Main.py"),
         "--server.port=7860",
         "--server.address=0.0.0.0",
         "--browser.gatherUsageStats=false",
         "--server.enableCORS=true",
-        "--theme.base=light"
+        "--theme.base=light",
+        "--server.enableWebsocketCompression=false"
     ]
-    subprocess.run(cmd)
+    
+    try:
+        # Use exec to replace the current process
+        os.execvp(sys.executable, streamlit_cmd)
+    except Exception as e:
+        print(f"❌ Failed to start Streamlit: {e}")
+        # Fallback to subprocess
+        subprocess.run(streamlit_cmd)
 
 if __name__ == "__main__":
-    print("🚀 Starting MoneyPrinterTurbo on Huggingface Spaces...")
+    print("=" * 50)
+    print("🚀 MoneyPrinterTurbo Starting on Huggingface Spaces")
+    print("=" * 50)
     
     # Check for environment variables without exposing which ones
     env_check_keys = ["OPENAI_API_KEY", "DEEPSEEK_API_KEY", "MOONSHOT_API_KEY", 
@@ -114,8 +147,17 @@ if __name__ == "__main__":
     if env_keys_count > 0:
         print(f"🔑 Found {env_keys_count} API key(s) in environment")
     else:
-        print("📝 Please configure API keys in the WebUI after startup")
+        print("📝 No API keys found in environment variables")
         print("📋 Required: LLM Provider API Key + Video Source API Key")
     
+    # Setup environment
     setup_environment()
+    
+    # Check system dependencies
+    check_system_dependencies()
+    
+    # Small delay to ensure everything is set up
+    time.sleep(2)
+    
+    # Start the application
     start_streamlit()

packages.txt

@@ -0,0 +1,6 @@
+ffmpeg
+libsm6
+libxext6
+libxrender-dev
+libglib2.0-0
+libgl1-mesa-glx

requirements.txt

@@ -1,12 +1,43 @@
+# Core dependencies
 streamlit==1.45.0
+fastapi==0.115.6
+uvicorn==0.34.0
+
+# Video processing
 moviepy==2.1.1
-edge_tts==6.1.19
+imageio-ffmpeg==0.5.1
+Pillow>=10.0.0
+
+# AI/LLM providers
 openai==1.56.1
-loguru==0.7.3
-google.generativeai==0.8.3
+google-generativeai==0.8.3
+
+# Text-to-Speech
+edge-tts==6.1.19
+azure-cognitiveservices-speech==1.40.0
+
+# HTTP and API
 requests>=2.31.0
+httpx>=0.25.0
 python-multipart==0.0.19
-pyyaml
-toml
-Pillow>=9.0.0
-imageio-ffmpeg
+
+# Configuration and data
+pyyaml>=6.0
+toml>=0.10.0
+pydantic>=2.0.0
+
+# Logging and utilities
+loguru==0.7.3
+
+# Background tasks
+celery==5.3.4
+redis>=4.0.0
+
+# System utilities
+psutil>=5.9.0
+
+# Audio processing (lightweight alternatives)
+pydub>=0.25.0
+
+# For Huggingface Spaces compatibility
+gradio-client>=0.7.0